diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index 1f45694..133e9f7 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -95,11 +95,13 @@ CLI 通过子命令提供帮助和版本信息，不使用 `--help`/`--version` ### 各阶段行为 -- **discuss**：不持久化讨论结果，完全依赖 AI 会话上下文传递；不设强制门控，通过提示词引导 -- **plan**：命令只输出提示词，不写入文件；AI 负责根据提示词生成文档内容并写入。重复调用同一文档的 plan 会追加已有内容用于增量修订。依赖未满足时有友好提示（非报错） +- **discuss**：不持久化讨论结果，完全依赖 AI 会话上下文传递；不设强制门控，通过提示词引导。讨论结束时引导用户运行 `rune create` 创建变更目录 +- **plan**：命令只输出提示词，不写入文件；AI 负责根据提示词生成文档内容并写入。新变更时引导用户先运行 `rune create` 创建目录。重复调用同一文档的 plan 会追加已有内容用于增量修订。依赖未满足时有友好提示（非报错） - **build**：按 task.md 的 checkbox 顺序执行；任务间无结构化依赖；可多次执行直到全部完成 - **archive**：归档前命令行校验 task 完成状态，未完成时在提示词中注入警告并引导 AI 询问用户 +**create**：CLI 辅助命令（非独立阶段），在 `.rune/changes/` 下创建变更目录。adapter 不为 create 生成独立的 skill/command 文件，使用引导嵌入在 discuss 和 plan 的 skill/command 内容中。 + ### 变更名校验 变更名仅支持中文、英文、短横线（`-`），不支持空格、下划线等其他符号。 diff --git a/README.md b/README.md index a41d732..8afd84e 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,8 @@ SDD 工作流包含固定的四个阶段，不可自定义增删： 3. **构建阶段** — `/rune-build <变更名>`：按 task.md 中的任务顺序逐个实现。每个任务完成后更新对应的 checkbox 为 `[x]`。可多次执行直到所有任务完成。 4. **归档阶段** — `/rune-archive <变更名>`：将变更目录移至 `archive/`。归档前自动检查 task.md 的完成状态，如有未完成任务会注入警告提示词，引导 AI 询问用户是否确认归档。 +> **辅助命令**：`rune create <变更名>` 用于在 `.rune/changes/` 下创建变更目录。它不是 SDD 阶段，而是在 discuss 结束后或 plan 开始前通过 CLI 运行的辅助命令。discuss 和 plan 的编辑器命令中已内嵌 create 的使用引导。 + ### 状态查看 ```bash @@ -66,6 +68,7 @@ bunx @lanyuanxiaoyao/rune version # 显示版本号 | `bunx @lanyuanxiaoyao/rune init ` | 初始化项目，注入编辑器配置 | | `bunx @lanyuanxiaoyao/rune update ` | 更新编辑器的命令和 skill 文件 | | `bunx @lanyuanxiaoyao/rune discuss` | 输出讨论阶段提示词 | +| `bunx @lanyuanxiaoyao/rune create <变更名>` | 创建变更目录（discuss 和 plan 之间的辅助命令） | | `bunx @lanyuanxiaoyao/rune plan <变更名> <文档名>` | 输出规划阶段提示词 | | `bunx @lanyuanxiaoyao/rune build <变更名>` | 输出构建阶段提示词 | | `bunx @lanyuanxiaoyao/rune archive <变更名>` | 输出归档阶段提示词，同时移动变更目录到 archive/ |