关于 autoplan
autoplan 是用于仓库工作的纯分析规划技能。它依据仓库证据调整计划深度,并将有出处的风险和结果关联检查分配到计划步骤。
主要功能
- 01请求分流与范围选择
- 02收集仓库证据
- 03风险视角与出处记录
- 04基于文件和契约的步骤
- 05关联结果检查的里程碑
适用场景
- 01实施前规划仓库变更
- 02界定迁移或安全敏感工作
- 03判断小型变更是否可直接处理
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ prathamdby/ skills --skill autoplan安装后在 Claude Code 中输入/autoplan确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
REFERENCE.mdreferences/compatibility.mdcost.mddata.mdoperations.mdrouter-contracts.mdsecurity.md详细介绍
Autoplan
仅进行分析。在当前对话中,或写入调用方指定的路径,交付一份计划。
选项与分流
默认:当前仓库、标准深度、在当前对话中输出。快速/草拟模式采用 Shape 和 Risks,并始终启用各项检查。全面/高风险/迁移任务采用深度模式,优先于快速模式;指定区域则用于限定证据范围。 遇到范围冲突时,缩小范围并在 Assumptions 中记录两种解读;绝不提问。
收集证据前,如果没有可落地的动词/对象/区域、非仓库意图没有可规划的目标,或请求的是构建而非规划,则返回
BLOCKED。指出缺少的内容并给出一个可行示例;拒绝时不输出任何检查/地图/里程碑。本技能不因构建请求而获准修改产品。
琐碎任务是指仅涉及一个模块、不改变契约/数据/签名,且行为可用一句话描述。返回 DIRECT,附上该句和三行内容:形态、文件、第一步;不执行任何检查。否则记录 intent | scope | depth | terminal。分流结束的条件是已确定 terminal,或已有明确的目标。
1. 证据
检查请求中的契约是否已经存在;若已有匹配项,则加以强化,而不是重建。找到同级 recon 的已安装 SKILL.md,以确定其锚点及共享/旧版记忆规则。读取头部可解析且经仓库验证的快照;不要仅为读取而触发刷新。若没有可用记忆,则对最多 30 个清单模块中的每个模块,最多冷扫描三个锚点。
若缺少 ADR 目录,则静默扫描 ADR 树(docs/adr/、adr/、doc/adr/、docs/decisions/)。记录 TODO、近期回退和重复内容。未提交内容是 Assumptions 中的补充信息,不能作为现有契约的证明。后续每项主张都须引用路径/测试/ADR、限定范围的无匹配结果,或明确标注的证据缺失 Assumption;引用继承而来的模式。完成条件:重要主张均有来源依据。
2. 检查
应用 REFERENCE.md 中所有始终启用的探查项:契约/API、失败/回滚、长期维护/债务。若涉及叶节点、操作手册或匹配器,还须应用
references/router-contracts.md。
为每个已启用检查维度的所有探查项评分;将命中项转化为有引用依据、由某个计划步骤负责的风险;每轮检查结束时,须注明引用、风险 → 步骤,或无证据。深度模式启用全部检查。否则仅加载触发的检查:
- Schema/回填、存储的产物、工具链:
references/data.md。 - 外部消费者/存储的载荷:
references/compatibility.md。 - 身份验证/密钥/PII/不可信输入:
references/security.md。 - 热路径/产生费用的调用:
references/cost.md。 - 服务/部署/分页:
references/operations.md。 每个未启用的检查维度都须用一行说明跳过原因。完成条件:每个已启用的探查项均已评分,且每项风险都有负责人。
3. 计划
说明决策、变更的契约、约束,以及偏离所引用模式之处;不要写实现主体或复述已有内容。标准/深度模式包括: Assumptions;Shape(粗体句子 + 模式);Layer map(NEW/CHANGED 的职责); 阶段顺序;文件与符号依据(正文:文件 + 契约步骤);按严重程度从高到低排列的 Risks(概率 × 影响,或明确说明判断);Milestones; 非目标;Handoff。草拟模式仅包含 Shape 和 Risks。
小型工作作为一个 PR;否则,每个里程碑都应是可审查的纵向 PR。从最精简的端到端契约/检查切片开始。列出已落地的符号、预期成功结果及相关失败结果,并说明能证明这些结果的断言或人工观察结果。仅仅返回 0 并不能证明成功。
Handoff 遵循调用方的下一步路径;默认先执行 /peer-review,再执行 ship。如果不会构建任何内容,例如仅涉及文档的计划,则使用 /peer-review 或停止。保留调用方明确指定的路径。
若行为已有依据或已作出假设、风险均有负责人,且每个里程碑都包含与结果关联的检查,则以 PLANNED 完成。
终止状态:PLANNED、DIRECT、BLOCKED。