27 lines
2.1 KiB
Markdown
27 lines
2.1 KiB
Markdown
---
|
|
name: plan-change
|
|
description: 分析软件需求或问题的现状、影响范围、依赖顺序、验证方式和风险，形成可执行变更计划。适用于新功能、增量修改、缺陷修复或重构的实施规划；详细技术设计、代码修改和仅需一步完成的简单操作不应触发。
|
|
---
|
|
|
|
# 变更计划
|
|
|
|
把目标转化为基于项目证据的实施步骤，不执行设计或编码，也不把尚未确认的方案写成既定事实。
|
|
|
|
## 工作流
|
|
|
|
1. 读取需求、适用的 `AGENTS.md`、`.craftkit/project.json`、相关规范和最小必要源码。
|
|
2. 区分新功能、增量修改、缺陷修复或重构；仅在分类影响计划时询问用户。
|
|
3. 确认当前行为、目标行为、范围外事项、依赖、兼容要求和验收标准。
|
|
4. 根据任务类型读取 [新功能](references/feature.md)、[现有变更](references/change.md) 或 [缺陷与重构](references/fix.md)。
|
|
5. 输出按依赖排序的步骤，每步包含目标、证据、修改范围、输入、产物、验证和停止条件。
|
|
6. 默认在对话中展示；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程计划使用 `workRoot`，共享计划使用 `designRoot`，后续设计沿用同一任务目录。
|
|
|
|
落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot/<task>/task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。
|
|
|
|
## 边界
|
|
|
|
- 不使用固定模块编码或不存在的下游 Skill 名称；文档默认落点允许由用户路径和项目配置覆盖。
|
|
- 无法从源码确认的运行行为标为待验证，不把推断写成事实。
|
|
- 计划应保护现有工作区，并把外部环境、数据迁移和发布验证与本地代码验证分开。
|
|
- 用户要求直接实施且任务简单明确时，不额外制造计划文档。
|