shadcn/improve：让 AI Agent 自主审计代码库并生成可执行改进计划

# 内部 Recon 流程伪代码
def recon(repo_path):
    stack = detect_stack(repo_path)           # Python? Node? Go?
    conventions = extract_conventions(repo_path)  # 规范列表
    gates = find_verification_commands(repo_path) # 测试/lint命令
    docs = ingest_design_docs(repo_path)       # 已有设计文档
    return RepoMap(stack, conventions, gates, docs)

# 九大审计维度
categories = [
    "correctness",   # 逻辑正确性
    "security",      # 安全性
    "perf",          # 性能
    "tests",         # 测试覆盖
    "tech-debt",     # 技术债务
    "deps",          # 依赖与迁移
    "dx",            # 开发体验
    "docs",          # 文档完整性
    "direction"      # 方向建议（需引用实际代码证据）
]

| # | Finding                    | Category  | Effort | Confidence |
|---|----------------------------|-----------|--------|------------|
| 1 | O(n²) icon migration...    | perf      | S      | HIGH       |

# Plan: 001-extract-shadow-config-resolution

**针对**: shadow-config 在 search.ts 和 view.ts 中重复定义

## 背景
当前 search.ts:31 存在 shadow-config 重复定义，已有代码示例...

## 步骤
1. 提取 shadow-config 到 `utils/shadow-config.ts`
2. 在 search.ts 和 view.ts 中替换为 import

## 验证门
\`\`\`bash
npm run lint
# 期望输出: 无错误
npm test
# 期望输出: 全部通过
\`\`\`

## STOP 条件
如果 search.ts 中存在其他对 shadow-config 的条件判断逻辑，
停止并报告，需要人工介入确认。

# 方式一：通过 npx 直接安装 Skill
npx skills add shadcn/improve

# 方式二：在支持 Agent Skills 的对话助手中使用
/improve  # 完整审计
/improve quick  # 快速扫描（只返回热点发现）
/improve deep  # 穷尽式审计（每个包、每个维度）

# 在目标仓库中启动 AI 助手，执行完整审计
/improve

# 回复示例后，选择感兴趣的发现
plan 1, 3, 5

# 生成计划文件到 plans/ 目录

# 只审计当前分支改动（PR 前推荐）
/improve branch

# 安全专项审计（同样支持 perf / tests / bugs）
/improve security

# 功能方向建议（需引用代码证据）
/improve next

# 跳过审计，直接描述需求生成计划
/improve plan <描述你要做的事情>

# 审核并优化已有计划
/improve review-plan plans/001-fix-n-plus-one.md

# 执行计划并自动审核执行结果
/improve execute 001

# 清理计划积压：验证完成项、刷新过期项、解封阻塞项
/improve reconcile

# 在其他 Agent 中执行已有计划
"implement plans/001-*.md"

# 或者让 improve 自己调度执行者
/improve execute 001