* docs(#2197): drop --validate docs for /gsd-plan-phase and /gsd-execute-phase These two commands never parse --validate (silent no-op); the flag is real only for /gsd-quick. Remove the false flag-table rows and CLI examples across COMMANDS.md and the how-to guides (en + ja-JP/zh-CN/ ko-KR/pt-BR mirrors), and correct the manager.flags.execute example from --validate to --cross-ai (a flag execute-phase actually parses). /gsd-quick's real --validate docs are left untouched. Ref #2197 * docs(#2197): add changeset for --validate docs removal --------- Co-authored-by: CI Rebase Check <ci@gsd-redux>
This commit is contained in:
@@ -171,7 +171,6 @@ v1.40 中,六个命名空间路由器作为第一阶段入口点随附发布
|
||||
| `--ingest <path-or-glob>` | 使用 ADR 文件代替 discuss-phase 进行上下文综合 |
|
||||
| `--ingest-format <auto\|nygard\|madr\|narrative>` | `--ingest` 的可选 ADR 解析器格式覆盖 |
|
||||
| `--reviews` | 根据 REVIEWS.md 中的跨 AI 审查反馈重新规划 |
|
||||
| `--validate` | 在规划开始前运行状态验证 |
|
||||
| `--bounce` | 规划完成后运行外部计划弹回验证(使用 `workflow.plan_bounce_script`) |
|
||||
| `--skip-bounce` | 即使配置中已启用也跳过计划弹回 |
|
||||
| `--mvp` | 垂直 MVP 模式 — 规划器将任务组织为功能切片(UI→API→DB),而非水平分层。在无先前阶段摘要的新项目第 1 阶段使用时,还会生成 `SKELETON.md`(行走骨架)。可通过在 ROADMAP.md 中设置 `**Mode:** mvp` 持久化应用于某阶段,届时无需标志即可自动应用 `--mvp`。 |
|
||||
@@ -200,7 +199,6 @@ v1.40 中,六个命名空间路由器作为第一阶段入口点随附发布
|
||||
/gsd-plan-phase 1 # 研究 + 规划 + 验证阶段 1
|
||||
/gsd-plan-phase 3 --skip-research # 无需研究直接规划(熟悉的领域)
|
||||
/gsd-plan-phase --auto # 非交互式规划
|
||||
/gsd-plan-phase 2 --validate # 规划前验证状态
|
||||
/gsd-plan-phase 1 --bounce # 规划 + 外部弹回验证
|
||||
/gsd-plan-phase 2 --ingest docs/adr/0010.md # 使用 ADR 快速通道进行上下文综合
|
||||
/gsd-plan-phase 2 --ingest 'docs/adr/00*.md' --ingest-format auto
|
||||
@@ -258,7 +256,6 @@ v1.40 中,六个命名空间路由器作为第一阶段入口点随附发布
|
||||
|----------|----------|-------------|
|
||||
| `N` | **是** | 要执行的阶段编号 |
|
||||
| `--wave N` | 否 | 仅执行阶段中的第 `N` 波 |
|
||||
| `--validate` | 否 | 在执行开始前运行状态验证 |
|
||||
| `--cross-ai` | 否 | 将执行委托给外部 AI CLI(使用 `workflow.cross_ai_command`) |
|
||||
| `--no-cross-ai` | 否 | 即使配置中启用了跨 AI 也强制本地执行 |
|
||||
|
||||
@@ -270,7 +267,6 @@ v1.40 中,六个命名空间路由器作为第一阶段入口点随附发布
|
||||
```bash
|
||||
/gsd-execute-phase 1 # 执行阶段 1
|
||||
/gsd-execute-phase 1 --wave 2 # 仅执行第 2 波
|
||||
/gsd-execute-phase 1 --validate # 执行前验证状态
|
||||
/gsd-execute-phase 2 --cross-ai # 将阶段 2 委托给外部 AI CLI
|
||||
```
|
||||
|
||||
@@ -588,7 +584,7 @@ ROADMAP.md 中阶段的 CRUD 操作 — 通过单一合并命令添加、插入
|
||||
"flags": {
|
||||
"discuss": "--auto",
|
||||
"plan": "--skip-research",
|
||||
"execute": "--validate"
|
||||
"execute": "--cross-ai"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -712,7 +712,7 @@ gsd-tools query config-set features.thinking_partner false
|
||||
|---------|------|---------|-------------|
|
||||
| `manager.flags.discuss` | string | (无) | 追加到 discuss-phase 命令的标志(如 `"--auto"`) |
|
||||
| `manager.flags.plan` | string | (无) | 追加到 plan-phase 命令的标志(如 `"--skip-research"`) |
|
||||
| `manager.flags.execute` | string | (无) | 追加到 execute-phase 命令的标志(如 `"--validate"`) |
|
||||
| `manager.flags.execute` | string | (无) | 追加到 execute-phase 命令的标志(如 `"--cross-ai"`) |
|
||||
|
||||
**示例:**
|
||||
|
||||
@@ -722,7 +722,7 @@ gsd-tools query config-set features.thinking_partner false
|
||||
"flags": {
|
||||
"discuss": "--auto",
|
||||
"plan": "--skip-research",
|
||||
"execute": "--validate"
|
||||
"execute": "--cross-ai"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -114,12 +114,6 @@ GSD 会跳过 `SUMMARY.md` 已存在的计划,仅为剩余计划分派执行
|
||||
/gsd-execute-phase 1 --wave 2
|
||||
```
|
||||
|
||||
如果您想在分派前验证 `.planning/` 的完整性:
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1 --validate
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 使用 `/gsd-undo` 回滚
|
||||
|
||||
@@ -45,18 +45,6 @@ GSD Core 仅执行第 2 波次的计划。它会首先检查所有较早波次
|
||||
|
||||
---
|
||||
|
||||
## 执行前验证状态
|
||||
|
||||
如果你怀疑 `.planning/` 目录与文件系统不同步——例如在崩溃或上一次运行中断之后——请传入 `--validate`:
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1 --validate
|
||||
```
|
||||
|
||||
GSD Core 在生成任何执行器之前运行状态一致性检查。检测到的偏差会被上报,你可以在继续之前接受或纠正。
|
||||
|
||||
---
|
||||
|
||||
## 恢复停滞的执行
|
||||
|
||||
如果执行中途停止——配额错误、网络断开或会话崩溃——波次级别的进度会被保留。GSD Core 会检查每个计划的 `SUMMARY.md` 文件;已有该文件的计划在重新运行时会自动跳过:
|
||||
|
||||
@@ -128,16 +128,6 @@ node gsd-tools.cjs config-set workflow.tdd_mode true
|
||||
|
||||
---
|
||||
|
||||
## 在规划开始前验证项目状态
|
||||
|
||||
```bash
|
||||
/gsd-plan-phase 2 --validate
|
||||
```
|
||||
|
||||
在启动研究代理前运行状态验证。如果怀疑 ROADMAP.md 或 STATE.md 已发生偏移,请使用此选项。
|
||||
|
||||
---
|
||||
|
||||
## 规划完成后运行外部弹跳验证
|
||||
|
||||
**如果已配置 `workflow.plan_bounce_script` 且需要对完成的计划进行外部验证:**
|
||||
|
||||
Reference in New Issue
Block a user