Files
CraftKit/plugins/dev/skills/plan-change/SKILL.md
T

2.1 KiB

name, description
name description
plan-change 分析软件需求或问题的现状、影响范围、依赖顺序、验证方式和风险,形成可执行变更计划。适用于新功能、增量修改、缺陷修复或重构的实施规划;详细技术设计、代码修改和仅需一步完成的简单操作不应触发。

变更计划

把目标转化为基于项目证据的实施步骤,不执行设计或编码,也不把尚未确认的方案写成既定事实。

工作流

  1. 读取需求、适用的 AGENTS.md、.craftkit/project.json、相关规范和最小必要源码。
  2. 区分新功能、增量修改、缺陷修复或重构;仅在分类影响计划时询问用户。
  3. 确认当前行为、目标行为、范围外事项、依赖、兼容要求和验收标准。
  4. 根据任务类型读取 新功能、现有变更 或 缺陷与重构。
  5. 输出按依赖排序的步骤,每步包含目标、证据、修改范围、输入、产物、验证和停止条件。
  6. 默认在对话中展示;用户要求保存时读取 .craftkit/project.json 的 documents 配置,过程计划使用 workRoot,共享计划使用 designRoot,后续设计沿用同一任务目录。

落盘前检索同主题的需求、设计、规范或知识,优先更新已有权威文档。共享长期文档新建或实质修改后按 .craftkit/standards/document-maintenance.md 更新审核状态;排版和错字修正不改变状态。rnrn写入后在 workRoot/<task>/task.json 登记本次创建、更新或引用的文档及 relationship;已有记录时保守合并。关联旧文档不转移所有权,也不产生删除权限;不修改项目级默认配置。

边界

  • 不使用固定模块编码或不存在的下游 Skill 名称;文档默认落点允许由用户路径和项目配置覆盖。
  • 无法从源码确认的运行行为标为待验证,不把推断写成事实。
  • 计划应保护现有工作区,并把外部环境、数据迁移和发布验证与本地代码验证分开。
  • 用户要求直接实施且任务简单明确时,不额外制造计划文档。