docs(#2197): drop --validate docs for /gsd-plan-phase and /gsd-execute-phase (#2574)

* 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:
Rezolv
2026-07-24 12:47:53 -04:00
committed by GitHub
parent 3b15a1e3cc
commit 155c08facf
24 changed files with 16 additions and 171 deletions

View File

@@ -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"
}
}
}

View File

@@ -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"
}
}
}

View File

@@ -114,12 +114,6 @@ GSD 会跳过 `SUMMARY.md` 已存在的计划,仅为剩余计划分派执行
/gsd-execute-phase 1 --wave 2
```
如果您想在分派前验证 `.planning/` 的完整性:
```bash
/gsd-execute-phase 1 --validate
```
---
## 使用 `/gsd-undo` 回滚

View File

@@ -45,18 +45,6 @@ GSD Core 仅执行第 2 波次的计划。它会首先检查所有较早波次
---
## 执行前验证状态
如果你怀疑 `.planning/` 目录与文件系统不同步——例如在崩溃或上一次运行中断之后——请传入 `--validate`:
```bash
/gsd-execute-phase 1 --validate
```
GSD Core 在生成任何执行器之前运行状态一致性检查。检测到的偏差会被上报,你可以在继续之前接受或纠正。
---
## 恢复停滞的执行
如果执行中途停止——配额错误、网络断开或会话崩溃——波次级别的进度会被保留。GSD Core 会检查每个计划的 `SUMMARY.md` 文件;已有该文件的计划在重新运行时会自动跳过:

View File

@@ -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` 且需要对完成的计划进行外部验证:**