improve 

improve 是一个专为代码库审计与任务规划设计的 Agent Skill。其核心理念是将高成本的智能叠加（理解架构、判断优先级、编写规格）交给强大的模型，而将低成本的执行（编码、测试、修复）交给更便宜的模型或人类。该技能本身从不修改源代码，其唯一产出是位于 plans/ 目录下的可执行 Markdown 计划文件。

核心工作流

1. 侦察与审计：映射仓库技术栈、约定及构建命令，并行扫描正确性、安全性、性能等九个维度。
2. 审查与优先级排序：过滤误报，按“影响力 ÷ 工作量”对发现结果进行排序，生成发现表格。
3. 制定计划：为选定的发现生成自包含的规格说明，内联代码摘录、验证命令及停止条件。
4. 执行与闭环：通过 /improve execute 分派廉价模型在隔离环境中实现，并由顾问模型评审结果；或通过 /improve reconcile 维护待办列表的健康度。

关键特性

• 🎯 职责分离：昂贵模型负责“想”，便宜模型负责“做”。计划文件是自包含的，任何代理或人类均可接手。
• 🛡️ 安全边界：技能仅读取和写入 plans/，绝不直接修改源码或运行写操作命令。执行者在隔离的 Git worktree 中工作，合并权始终在用户手中。
• 📝 可执行计划：每个计划都包含精确的文件路径、当前代码片段、经过验证的 lint/test 命令作为门控，以及明确的 STOP 条件，确保即使是最弱的执行者也能准确完成任务。
• 🔄 闭环管理：支持 reconcile 刷新漂移的计划，branch 审计当前分支更改，以及 --issues 将计划同步为 GitHub Issues。

常用命令

安装与使用

npx skills add shadcn/improve

适用于任何支持 Agent Skills 格式的代理（如 Claude Code, Codex 等）。

典型首次运行：

1. 运行 /improve quick 进行低成本扫描。
2. 从返回的发现表格中选择需要处理的项目（如“规划 1、3 和 5”）。
3. 阅读生成的 plans/*.md 文件。
4. 运行 /improve execute 001 让廉价模型实现第一个计划，或手动将计划交给其他工具。
5. 评审执行报告，决定是否合并。