1.9 KiB
1.9 KiB
name, description
| name | description |
|---|---|
| plan-change | 分析软件需求或问题的现状、影响范围、依赖顺序、验证方式和风险,形成可执行变更计划。适用于新功能、增量修改、缺陷修复或重构的实施规划;详细技术设计、代码修改和仅需一步完成的简单操作不应触发。 |
变更计划
把目标转化为基于项目证据的实施步骤,不执行设计或编码,也不把尚未确认的方案写成既定事实。
工作流
- 读取需求、适用的
AGENTS.md、.craftkit/project.json、相关规范和最小必要源码。 - 区分新功能、增量修改、缺陷修复或重构;仅在分类影响计划时询问用户。
- 确认当前行为、目标行为、范围外事项、依赖、兼容要求和验收标准。
- 根据任务类型读取 新功能、现有变更 或 缺陷与重构。
- 输出按依赖排序的步骤,每步包含目标、证据、修改范围、输入、产物、验证和停止条件。
- 默认在对话中展示;用户要求保存时读取
.craftkit/project.json的documents配置,过程计划使用workRoot,共享计划使用designRoot,后续设计沿用同一任务目录。
写入后在 workRoot/<task>/task.json 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 knowledge:document-output 的生命周期规则,不修改项目级默认配置。
边界
- 不使用固定模块编码或不存在的下游 Skill 名称;文档默认落点允许由用户路径和项目配置覆盖。
- 无法从源码确认的运行行为标为待验证,不把推断写成事实。
- 计划应保护现有工作区,并把外部环境、数据迁移和发布验证与本地代码验证分开。
- 用户要求直接实施且任务简单明确时,不额外制造计划文档。