no-mistakes(document): Sync onboarding docs

This commit is contained in:
Jeremy McSpadden
2026-07-03 17:20:34 -05:00
committed by Codesmith
parent 2f2d33aea7
commit 2c878c966f
21 changed files with 31 additions and 31 deletions

View File

@@ -288,14 +288,14 @@ node gsd-tools.cjs scaffold phase-dir --phase N --name "phase name"
## Init 命令(复合上下文加载)
通过单次调用加载特定工作流所需的所有上下文。返回包含项目信息、配置、状态和工作流专属数据的 JSON。`init onboard [--fast]` 会为 `/gsd-onboard` 返回 brownfield 信号、planning 文档候选、代码库映射完整性、fast 映射就绪状态、部分 planning 状态和 onboarding summary 状态。
通过单次调用加载特定工作流所需的所有上下文。返回包含项目信息、配置、状态和工作流专属数据的 JSON。`init onboard [--fast] [--text]` 会为 `/gsd-onboard` 返回 brownfield 信号、planning 文档候选、代码库映射完整性、fast 映射就绪状态、文本模式路由、部分 planning 状态和 onboarding summary 状态。
```bash
node gsd-tools.cjs init execute-phase <phase>
node gsd-tools.cjs init plan-phase <phase>
node gsd-tools.cjs init new-project
node gsd-tools.cjs init new-milestone
node gsd-tools.cjs init onboard [--fast]
node gsd-tools.cjs init onboard [--fast] [--text]
node gsd-tools.cjs init quick <description>
node gsd-tools.cjs init resume
node gsd-tools.cjs init verify-work <phase>

View File

@@ -57,7 +57,7 @@ v1.40 中,六个命名空间路由器作为第一阶段入口点随附发布
| 标志 | 描述 |
|------|-------------|
| `--fast` | 优先使用轻量 `/gsd-map-codebase --fast` 映射交接 |
| `--fast` | 优先使用轻量 `/gsd-map-codebase --fast` 映射交接;在 `/gsd-new-project` 前仍需要完整映射 |
| `--text` | 使用编号纯文本关卡,而不是 TUI 菜单 |
**前提条件:** 现有仓库或规划文档。空的绿地项目请使用 `/gsd-new-project`。
@@ -65,7 +65,7 @@ v1.40 中,六个命名空间路由器作为第一阶段入口点随附发布
```bash
/gsd-onboard # 引导式 brownfield 接入
/gsd-onboard --fast # 先使用轻量代码库映射
/gsd-onboard --fast # 先使用轻量映射,并在项目设置前补全完整映射
```
---

View File

@@ -814,7 +814,7 @@
**需求:**
- REQ-ONBOARD-01:系统必须检测现有代码、package manifest、规划文档、部分 `.planning/` 状态以及缺失的代码库映射文件。
- REQ-ONBOARD-02:当 brownfield 缺少完整 `.planning/codebase/` 时,系统必须交接到 `/gsd-map-codebase` 或 `/gsd-map-codebase --fast`。
- REQ-ONBOARD-02:当 brownfield 缺少所需 `.planning/codebase/` 映射文件时,系统必须交接到 `/gsd-map-codebase` 或 `/gsd-map-codebase --fast`。fast 映射 readiness 是部分状态,不得视为足以运行 `/gsd-new-project`。
- REQ-ONBOARD-03:当存在 ADR/PRD/SPEC/RFC 候选且 project 不存在时,系统必须在 `/gsd-new-project` 前提供 `/gsd-ingest-docs`。
- REQ-ONBOARD-04:在 `PROJECT.md`、`REQUIREMENTS.md`、`ROADMAP.md`、`STATE.md` 全部存在前,系统不得报告 onboarding 完成。
- REQ-ONBOARD-05:系统必须仅在 project setup 后创建或确认 `.planning/onboarding/SUMMARY.md`。

View File

@@ -52,7 +52,7 @@ claude --dangerously-skip-permissions
/gsd-onboard
```
如果 onboarding 报告缺少代码库映射,请选择推荐选项并运行打印出的 `/gsd-map-codebase` 交接命令,然后重新运行 `/gsd-onboard`。`/gsd-map-codebase` 会派生四个并行映射子代理(您将看到"Spawning 4 parallel codebase mapper agents…"——这需要 1–5 分钟;请勿中断)。每个代理专注于不同的关注点:
如果 onboarding 报告缺少代码库映射,请选择推荐选项并运行打印出的 `/gsd-map-codebase` 交接命令,然后重新运行 `/gsd-onboard`。`/gsd-onboard --fast` 只适合轻量首次通过;在 `/gsd-new-project` 前仍需要完整映射。`/gsd-map-codebase` 会派生四个并行映射子代理(您将看到"Spawning 4 parallel codebase mapper agents…"——这需要 1–5 分钟;请勿中断)。每个代理专注于不同的关注点:
| 代理 | 关注点 |
|-------|-------|