docs(#2420): clean stale get-shit-done/ path refs in translated docs (#2421)

After the package/repo rename in #604, the English docs were updated to
use gsd-core/... paths, but the four translated doc trees (ja-JP, zh-CN,
ko-KR, pt-BR) and .changeset/README.md were never updated and still
referenced the pre-rename get-shit-done/ runtime directory, which no
longer exists.

This commit brings the translations in line with the English docs:

  - docs/{ja-JP,zh-CN,ko-KR,pt-BR}/**/*.md (57 files):
      get-shit-done/ -> gsd-core/  (path references)
      #references-get-shit-donereferencesmd -> #references-gsd-corereferencesmd
                                            (anchor in INVENTORY -> ARCHITECTURE links)
  - .changeset/README.md:9 issue URL:
      open-gsd/get-shit-done-redux -> open-gsd/gsd-core

Legacy references intentionally preserved (historical record):
  - CHANGELOG.md, .changeset/archived/*, docs/RELEASE-NOTES-LEGACY.md
  - docs/cleanup-get-shit-done-cc.md, docs/adr/*, docs/research/*
  - docs/{ja-JP,ko-KR}/superpowers/plans/2026-03-18-* (developer's local paths)
  - docs/{INVENTORY,README,FEATURES,installer-migrations}.md (rename-history
    descriptions, some tagged <!-- gsd-allow-legacy-name -->)
  - Code/tests implementing or testing legacy-cleanup logic
    (bin/install.js, gsd-core/bin/lib/legacy-cleanup.cjs,
    scripts/lint-legacy-dir-name.cjs, migration sources/tests)

No source code changes — documentation only.

Fixes #2420
This commit is contained in:
Tom Boucher
2026-07-18 23:11:15 -04:00
committed by GitHub
parent 873bdf51e5
commit b2f4aa9435
58 changed files with 176 additions and 176 deletions

View File

@@ -42,7 +42,7 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
│
┌─────────────────────▼────────────────────────────────┐
│ WORKFLOW LAYER │
│ get-shit-done/workflows/*.md — Orchestration logic │
│ gsd-core/workflows/*.md — Orchestration logic │
│ (Reads references, spawns agents, manages state) │
└──────┬──────────────┬─────────────────┬──────────────┘
│ │ │
@@ -75,7 +75,7 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
### 2. 轻量级编排器
工作流文件(`get-shit-done/workflows/*.md`)不承担繁重工作。它们:
工作流文件(`gsd-core/workflows/*.md`)不承担繁重工作。它们:
- 通过 `gsd-tools.cjs init <workflow>` 加载上下文
- 以聚焦的提示词派生专用 Agent
@@ -130,7 +130,7 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
急于列举技能是每轮两种反复出现的 token 开销之一。另一种是 `.claude/settings.json` 中每个已启用 MCP 服务器注入的 MCP 工具 schema。重型 MCP 服务器(browser/playwright、Mac-tools、Windows-tools)每轮各自可消耗 20k+ token——通常远超 `model_profile` 调优所节省的量。该开关位于 Claude Code 框架中(`.claude/settings.json` 中的 `enabledMcpjsonServers` / `disabledMcpjsonServers`),**不属于** GSD 的关注范围。两阶段路由层(#2792)和严格的 MCP 启用管理是每轮最大的成本杠杆。请参阅 [`docs/USER-GUIDE.md`](USER-GUIDE.md) 和 `references/context-budget.md` 了解审计清单。
### 工作流(`get-shit-done/workflows/*.md`)
### 工作流(`gsd-core/workflows/*.md`)
命令所引用的编排逻辑,包含逐步流程:
@@ -152,7 +152,7 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
| `LARGE` | 1500 — 多步骤规划器和大型功能工作流 |
| `DEFAULT` | 1000 — 聚焦于单一目的的工作流(目标层级) |
根据 discuss-phase 字节预算(#717;discuss-phase/modes 分割使其保持在 ≈32000 字节),`workflows/discuss-phase.md` 须严格遵守更严格的上限。当工作流超出其层级时,应将各模式的主体提取到 `workflows/<workflow>/modes/<mode>.md`,将模板提取到 `workflows/<workflow>/templates/`,将共享知识提取到 `get-shit-done/references/`。父文件成为轻量级调度器,仅读取当前调用所需的模式和模板文件。
根据 discuss-phase 字节预算(#717;discuss-phase/modes 分割使其保持在 ≈32000 字节),`workflows/discuss-phase.md` 须严格遵守更严格的上限。当工作流超出其层级时,应将各模式的主体提取到 `workflows/<workflow>/modes/<mode>.md`,将模板提取到 `workflows/<workflow>/templates/`,将共享知识提取到 `gsd-core/references/`。父文件成为轻量级调度器,仅读取当前调用所需的模式和模板文件。
`workflows/discuss-phase/` 是该模式的典型示例——父文件负责调度,`modes/` 存放各标志的行为(`power.md`、`all.md`、`auto.md`、`chain.md`、`text.md`、`batch.md`、`analyze.md`、`default.md`、`advisor.md`),`templates/` 存放 CONTEXT.md、DISCUSSION-LOG.md 以及仅在写入对应输出文件时才读取的 checkpoint.json schema。
@@ -167,7 +167,7 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
**Agent 总数:** 33
### 参考文档(`get-shit-done/references/*.md`)
### 参考文档(`gsd-core/references/*.md`)
工作流和 Agent 通过 `@-reference` 引用的共享知识文档(请参阅 [`docs/INVENTORY.md`](INVENTORY.md#references-41-shipped) 获取权威数量及完整列表):
@@ -221,7 +221,7 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
- `planner-reviews.md` — 跨 AI 审查集成(从 `/gsd-review` 读取 REVIEWS.md)
- `planner-revision.md` — 用于迭代细化的计划修订模式
### 模板(`get-shit-done/templates/`)
### 模板(`gsd-core/templates/`)
所有规划产物的 Markdown 模板。由 `gsd-tools.cjs template fill` / `phase.scaffold`(以及顶级 `scaffold`)使用,以创建预结构化文件:
- `project.md`、`requirements.md`、`roadmap.md`、`state.md` — 核心项目文件
@@ -253,13 +253,13 @@ GSD Core 是一个**元提示框架**,位于用户与 AI 编码 Agent(Claude
请参阅 [`docs/INVENTORY.md`](INVENTORY.md#hooks-11-shipped) 获取权威的 11 个 hook 列表。
### 命令路由中枢(`get-shit-done/bin/lib/command-routing-hub.cjs`)
### 命令路由中枢(`gsd-core/bin/lib/command-routing-hub.cjs`)
CJS 命令族路由器通过 `CommandRoutingHub` 进行调度。中枢拥有不抛出异常的纯结果契约(`hub.dispatch()` 捕获内部异常并返回 `{ ok: false, kind, ...typedPayload }`)以及封闭的运行时错误分类(`UnknownCommand`、`InvalidArgs`、`HandlerRefusal`、`HandlerFailure`)。路由器适配器保持为轻量级 CLI 转换器——它们构建中枢、调用 `dispatch`,然后将结果映射到 `output()`/`error()` 调用。运行时为单路径(无双运行时模式选择)。参见 `docs/adr/0174-retire-gsd-sdk-package-boundary.md`。
### CLI 工具(`get-shit-done/bin/`)
### CLI 工具(`gsd-core/bin/`)
Node.js CLI 工具(`gsd-tools.cjs`),其领域模块分布在 `get-shit-done/bin/lib/` 中(请参阅 [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) 获取权威列表):
Node.js CLI 工具(`gsd-tools.cjs`),其领域模块分布在 `gsd-core/bin/lib/` 中(请参阅 [`docs/INVENTORY.md`](INVENTORY.md#cli-modules-33-shipped) 获取权威列表):
| 模块 | 职责 |
@@ -466,7 +466,7 @@ UI-SPEC.md (per phase) ───────────────────
~/.claude/ # Claude Code (global install)
├── skills/gsd-*/SKILL.md # Global skills (authoritative roster: docs/INVENTORY.md)
├── commands/gsd/*.md # Local Claude installs use slash commands instead of global skills
├── get-shit-done/
├── gsd-core/
│ ├── bin/gsd-tools.cjs # CLI utility
│ ├── bin/lib/*.cjs # Domain modules (authoritative roster: docs/INVENTORY.md)
│ ├── workflows/*.md # Workflow definitions (authoritative roster: docs/INVENTORY.md)

View File

@@ -1,6 +1,6 @@
# GSD CLI 工具参考
> `gsd-tools` CLI(`get-shit-done/bin/gsd-tools.cjs`)参考文档。斜杠命令与用户流程请参见[命令参考](COMMANDS.md)。返回[文档索引](README.md)。
> `gsd-tools` CLI(`gsd-core/bin/gsd-tools.cjs`)参考文档。斜杠命令与用户流程请参见[命令参考](COMMANDS.md)。返回[文档索引](README.md)。
---
@@ -11,8 +11,8 @@
| | |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **发布路径** | `get-shit-done/bin/gsd-tools.cjs` |
| **实现** | `get-shit-done/bin/lib/` 下的 20 个领域模块(以该目录为准) |
| **发布路径** | `gsd-core/bin/gsd-tools.cjs` |
| **实现** | `gsd-core/bin/lib/` 下的 20 个领域模块(以该目录为准) |
| **状态** | 编排、工作流和自动化的主要运行时命令接口。 |
@@ -488,7 +488,7 @@ Slug 将针对 `[a-zA-Z0-9_-]+` 进行验证;空或包含路径的 slug 将被
## 密钥处理
通过 `/gsd-settings` 配置的 API 密钥(`brave_search`、`firecrawl`、`exa_search`)以明文形式写入 `.planning/config.json`,但在所有 `config-set` / `config-get` 输出、确认表格和交互式提示中均会被遮蔽(`****<last-4>`)。遮蔽实现请参见 `get-shit-done/bin/lib/secrets.cjs`。`config.json` 文件本身是安全边界——请通过文件系统权限保护它,并将其排除在 git 之外(`.planning/` 默认已被 gitignore)。
通过 `/gsd-settings` 配置的 API 密钥(`brave_search`、`firecrawl`、`exa_search`)以明文形式写入 `.planning/config.json`,但在所有 `config-set` / `config-get` 输出、确认表格和交互式提示中均会被遮蔽(`****<last-4>`)。遮蔽实现请参见 `gsd-core/bin/lib/secrets.cjs`。`config.json` 文件本身是安全边界——请通过文件系统权限保护它,并将其排除在 git 之外(`.planning/` 默认已被 gitignore)。
---

View File

@@ -608,7 +608,7 @@ ROADMAP.md 中阶段的 CRUD 操作 — 通过单一合并命令添加、插入
/gsd-help --brief <topic> # 简洁的范围查找 — 签名 + 单行摘要
```
完整别名表请参阅 `get-shit-done/workflows/help/modes/topic.md`。未知主题将打印已识别的列表。
完整别名表请参阅 `gsd-core/workflows/help/modes/topic.md`。未知主题将打印已识别的列表。
---

View File

@@ -184,7 +184,7 @@ API 密钥字段接受字符串值(密钥本身)。也可以设置为哨兵
| `firecrawl` | string \| boolean \| null | `null` | 用于深度抓取的 Firecrawl API 密钥。显示时已脱敏 |
| `exa_search` | string \| boolean \| null | `null` | 用于语义搜索的 Exa Search API 密钥。显示时已脱敏 |
**脱敏规范(`get-shit-done/bin/lib/secrets.cjs`):** 8 个字符及以上的密钥显示为 `****<末4位>`;较短的密钥显示为 `****`;`null`/空值显示为 `(unset)`。明文原样写入 `.planning/config.json`——该文件是安全边界——但 CLI、确认表格、日志和 `AskUserQuestion` 描述中不显示明文。这也适用于 `config-set` 命令本身的输出:`config-set brave_search <key>` 返回带脱敏值的 JSON 负载。
**脱敏规范(`gsd-core/bin/lib/secrets.cjs`):** 8 个字符及以上的密钥显示为 `****<末4位>`;较短的密钥显示为 `****`;`null`/空值显示为 `(unset)`。明文原样写入 `.planning/config.json`——该文件是安全边界——但 CLI、确认表格、日志和 `AskUserQuestion` 描述中不显示明文。这也适用于 `config-set` 命令本身的输出:`config-set brave_search <key>` 返回带脱敏值的 JSON 负载。
### 代码审查 CLI 路由
@@ -256,7 +256,7 @@ API 密钥字段接受字符串值(密钥本身)。也可以设置为哨兵
| `workflow.plan_chunked` | boolean | `false` | 启用分块规划模式。为 `true`(或向 `/gsd-plan-phase` 传递 `--chunked` 标志)时,编排器将单个长期规划器任务拆分为一个简短的轮廓任务,后跟 N 个简短的按计划任务(每个约 3-5 分钟)。每个计划单独提交以具备崩溃韧性。如果任务挂起且终端被强制终止,使用 `--chunked` 重新运行将从最后完成的计划处恢复。在长期任务可能在 stdio 上挂起的 Windows 上特别有用。v1.38 新增 |
| `workflow.code_review_command` | string | (无) | `/gsd-ship` 中外部代码审查集成的 shell 命令。通过 stdin 接收更改的文件路径。非零退出阻塞发布工作流。v1.36 新增 |
| `workflow.tdd_mode` | boolean | `false` | 将 TDD 流水线作为一等执行模式启用。为 `true` 时,规划器积极地将 `type: tdd` 应用于符合条件的任务(业务逻辑、API、验证、算法),执行器强制执行 RED/GREEN/REFACTOR 门禁序列。阶段结束时的协作审查检查点验证门禁合规性。v1.36 新增 |
| `workflow.human_verify_mode` | string | `'end-of-phase'` | 控制人工验证检查点。`'end-of-phase'`(自 #3309 起为默认值)抑制 `checkpoint:human-verify` 任务,并将检查嵌入 `<verify><human-check>` 块以供阶段结束审查。`'mid-flight'` 恢复阻塞式检查点任务。`checkpoint:decision` 和 `checkpoint:human-action` 不受影响。参见[检查点参考](../../get-shit-done/references/checkpoints.md#checkpoint_types)。 |
| `workflow.human_verify_mode` | string | `'end-of-phase'` | 控制人工验证检查点。`'end-of-phase'`(自 #3309 起为默认值)抑制 `checkpoint:human-verify` 任务,并将检查嵌入 `<verify><human-check>` 块以供阶段结束审查。`'mid-flight'` 恢复阻塞式检查点任务。`checkpoint:decision` 和 `checkpoint:human-action` 不受影响。参见[检查点参考](../../gsd-core/references/checkpoints.md#checkpoint_types)。 |
| `workflow.cross_ai_execution` | boolean | `false` | 将阶段执行委托给外部 AI CLI,而非派生本地执行器 agent。适用于利用不同模型在特定阶段的优势。v1.36 新增 |
| `workflow.cross_ai_command` | string | (无) | 跨 AI 执行的 shell 命令模板。通过 stdin 接收阶段提示词。必须生成与 SUMMARY.md 兼容的输出。当 `cross_ai_execution` 为 `true` 时必需。v1.36 新增 |
| `workflow.cross_ai_timeout` | number | `300` | 跨 AI 执行命令的超时秒数。防止失控的外部进程。v1.36 新增 |
@@ -285,7 +285,7 @@ API 密钥字段接受字符串值(密钥本身)。也可以设置为哨兵
## 发布设置
`ship.pr_body_sections` 为 `/gsd-ship` 添加额外的 PR 正文节,用于项目特定的 PRD/PR 正文内容,而无需编辑 `get-shit-done/workflows/ship.md`。
`ship.pr_body_sections` 为 `/gsd-ship` 添加额外的 PR 正文节,用于项目特定的 PRD/PR 正文内容,而无需编辑 `gsd-core/workflows/ship.md`。
有关入门示例和故障排除的用户指南,请参阅[自定义 PR 正文节](../ship-pr-body-sections.md)。
@@ -757,7 +757,7 @@ gsd-tools query config-set features.thinking_partner false
| gsd-doc-writer | Opus | Sonnet | Haiku | Sonnet | Inherit |
| gsd-doc-verifier | Sonnet | Sonnet | Haiku | Haiku | Inherit |
> **所有 33 个发布 agent 在目录(`sdk/shared/model-catalog.json`)中均有显式的按配置文件层级分配。** 上表显示最常用 agent 的代表性子集。对于此处未列出的 agent,`model_overrides` 接受任何已发布的 agent 名称。权威的配置文件数据通过 `get-shit-done/bin/lib/model-catalog.cjs` 和 `sdk/src/model-catalog.ts` 从 `sdk/shared/model-catalog.json` 导出。
> **所有 33 个发布 agent 在目录(`sdk/shared/model-catalog.json`)中均有显式的按配置文件层级分配。** 上表显示最常用 agent 的代表性子集。对于此处未列出的 agent,`model_overrides` 接受任何已发布的 agent 名称。权威的配置文件数据通过 `gsd-core/bin/lib/model-catalog.cjs` 和 `sdk/src/model-catalog.ts` 从 `sdk/shared/model-catalog.json` 导出。
### 按 Agent 覆盖

View File

@@ -2095,7 +2095,7 @@ PreToolUse 钩子,检测 Claude 在 GSD 工作流上下文之外尝试文件
### 92. 门控分类
**参考:** `get-shit-done/references/gates.md`
**参考:** `gsd-core/references/gates.md`
**智能体:** plan-checker、verifier
**目的:** 定义构建所有工作流决策点的 4 种规范门控类型,使 plan-checker 和 verifier 智能体能够应用一致的门控逻辑。
@@ -2944,7 +2944,7 @@ explicit reviewer flags -> --all -> review.default_reviewers -> all detected rev
- REQ-HUMAN-VERIFY-02:人工需要的验证必须保持待处理,直到阶段末审查解决。
- REQ-HUMAN-VERIFY-03:没有该键的配置必须使用 `"end-of-phase"`。
**参考:** [检查点参考](../../get-shit-done/references/checkpoints.md)
**参考:** [检查点参考](../../gsd-core/references/checkpoints.md)
---

View File

@@ -169,7 +169,7 @@
## 工作流 (88 shipped)
完整清单位于 `get-shit-done/workflows/*.md`。工作流是命令在内部引用的轻量编排器;大多数不由最终用户直接阅读。以下行将每个工作流文件映射到其角色(来源于 `<purpose>` 块),以及在适用情况下映射到调用它的命令。
完整清单位于 `gsd-core/workflows/*.md`。工作流是命令在内部引用的轻量编排器;大多数不由最终用户直接阅读。以下行将每个工作流文件映射到其角色(来源于 `<purpose>` 块),以及在适用情况下映射到调用它的命令。
| 工作流 | 角色 | 调用者 |
|--------|------|--------|
@@ -268,7 +268,7 @@
## 参考资料 (62 shipped)
完整清单位于 `get-shit-done/references/*.md`。参考资料是工作流和代理 `@-reference` 的共享知识文档。以下分组与 [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-get-shit-donereferencesmd) 一致 — 核心、工作流、思维模型集群和模块化规划器分解。
完整清单位于 `gsd-core/references/*.md`。参考资料是工作流和代理 `@-reference` 的共享知识文档。以下分组与 [`docs/ARCHITECTURE.md`](ARCHITECTURE.md#references-gsd-corereferencesmd) 一致 — 核心、工作流、思维模型集群和模块化规划器分解。
### 核心参考资料
@@ -363,13 +363,13 @@
| `user-story-template.md` | MVP 规划的用户故事格式 — "作为 / 我想要 / 以便" 结构化字段。 |
| `spidr-splitting.md` | 用于在 MVP 模式下处理大型用户故事的 SPIDR 拆分分解规则。 |
> **子目录:** `get-shit-done/references/few-shot-examples/` 包含额外的少样本示例(`plan-checker.md`、`verifier.md`),这些示例从特定代理中引用。它们不计入 62 个顶级参考资料。
> **子目录:** `gsd-core/references/few-shot-examples/` 包含额外的少样本示例(`plan-checker.md`、`verifier.md`),这些示例从特定代理中引用。它们不计入 62 个顶级参考资料。
---
## CLI 模块 (81 shipped)
完整清单:`get-shit-done/bin/lib/*.cjs`。
完整清单:`gsd-core/bin/lib/*.cjs`。
| 模块 | 职责 |
|------|------|
@@ -443,7 +443,7 @@
| `task-command-router.cjs` | `gsd-tools task` 的轻量 CJS 子命令路由适配器 |
| `template.cjs` | 带变量替换的模板选择和填充 |
| `uat.cjs` | UAT 文件解析、验证债务跟踪、audit-uat 支持 |
| `ui-safety-gate.cjs` | 无 shell 的词边界 UI 令牌检测器(#3706,#3718);从 stdin 读取阶段章节文本,退出 0(找到 UI)或 1(未找到 UI);也部署到 `get-shit-done/bin/lib/`,以便 GSD 安装程序将其传送到 `$RUNTIME_DIR`(#448) |
| `ui-safety-gate.cjs` | 无 shell 的词边界 UI 令牌检测器(#3706,#3718);从 stdin 读取阶段章节文本,退出 0(找到 UI)或 1(未找到 UI);也部署到 `gsd-core/bin/lib/`,以便 GSD 安装程序将其传送到 `$RUNTIME_DIR`(#448) |
| `update-context.cjs` | `/gsd:update` 的纯安装上下文解析器 — 从 update.md bash 移植的运行时/范围/配置目录/版本检测(LOCAL/GLOBAL/UNKNOWN);支持 `gsd-tools update-context`(#498) |
| `validate-command-router.cjs` | `gsd-tools validate` 的轻量 CJS 子命令路由适配器 |
| `validate.cjs` | 纯阶段变体规范化帮助器(`phaseVariants`、`buildRoadmapPhaseVariants`、`buildNotStartedPhaseVariants`),被 `verify.cjs` 用于 W006/W007 检查;无 I/O,无异步 |

View File

@@ -561,14 +561,14 @@ claude --dangerously-skip-permissions
### 程序化 CLI(`gsd-tools query` 与 `gsd-tools.cjs`)
对于自动化,优先使用带有已注册子命令的 **`gsd-tools query`**(参见 [CLI-TOOLS.md — SDK 和程序化访问](CLI-TOOLS.md#sdk-and-programmatic-access) 及 QUERY-HANDLERS.md)。旧版 `node $HOME/.claude/get-shit-done/bin/gsd-tools.cjs` CLI 仍受支持。
对于自动化,优先使用带有已注册子命令的 **`gsd-tools query`**(参见 [CLI-TOOLS.md — SDK 和程序化访问](CLI-TOOLS.md#sdk-and-programmatic-access) 及 QUERY-HANDLERS.md)。旧版 `node $HOME/.claude/gsd-core/bin/gsd-tools.cjs` CLI 仍受支持。
### STATE.md 不同步
```bash
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate # Detect drift
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify # Preview changes
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md
node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate # Detect drift
node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify # Preview changes
node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync # Reconstruct STATE.md
```
### 命令在"Spawning..."后似乎冻结
@@ -666,7 +666,7 @@ GSD 子 Agent 在单独的上下文窗口中运行——其工作在进行中对
每个被禁用的服务器都会从后续每次交互中移除其模式。精简 MCP **与** `model_profile` 调整形成叠加效果——两个杠杆是累加的,MCP 节省效果立即体现在编排器生成的每个子 Agent 上。
完整审计、运行时参考及与 `model_profile` 的组合说明,请参阅捆绑的 `context-budget.md` 参考中的 [MCP 工具模式成本](../../get-shit-done/references/context-budget.md#mcp-tool-schema-cost-harness-concern)。
完整审计、运行时参考及与 `model_profile` 的组合说明,请参阅捆绑的 `context-budget.md` 参考中的 [MCP 工具模式成本](../../gsd-core/references/context-budget.md#mcp-tool-schema-cost-harness-concern)。
### 使用非 Claude 运行时(Codex、OpenCode、Gemini CLI、Kilo)

View File

@@ -48,7 +48,7 @@ GSD Core 的核心洞见是:编码会话中*大多数*工作根本无需在主
**规格驱动开发**意味着每个阶段在执行开始之前都会生成结构化产物。`CONTEXT.md` 捕获来自讨论步骤的实现决策。`RESEARCH.md` 记录研究智能体的发现。`PLAN.md` 将工作分解为离散的、按依赖关系排序的任务,并附有明确的验收标准。在执行器智能体接触文件之时,它已拥有一份精确的规格说明——而非对一段漫长对话的重新解读。
**元提示**意味着智能体定义本身就是经过精心设计的提示,而非临时指令。`get-shit-done/workflows/` 和 `agents/` 中的文件编码了关于如何限定任务范围、需要验证什么,以及何时上报至人工检查点的宝贵经验。用户无需在每次会话中重新解释这些知识;它已内嵌于系统自身的提示中。
**元提示**意味着智能体定义本身就是经过精心设计的提示,而非临时指令。`gsd-core/workflows/` 和 `agents/` 中的文件编码了关于如何限定任务范围、需要验证什么,以及何时上报至人工检查点的宝贵经验。用户无需在每次会话中重新解释这些知识;它已内嵌于系统自身的提示中。
这种组合是刻意为之的。全新上下文确保每个智能体清晰推理。规格驱动的产物确保每个智能体针对*正确的*事物进行推理。元提示确保每个智能体知道*如何*将其做好。

View File

@@ -24,7 +24,7 @@ GSD Core 的多智能体设计正是对这一问题的直接回应。与其让
## 编排器 → 智能体模式
`get-shit-done/workflows/` 中的每个工作流都遵循相同的结构:
`gsd-core/workflows/` 中的每个工作流都遵循相同的结构:
```text
Orchestrator (workflow .md file)

View File

@@ -62,7 +62,7 @@ GSD Core 生成的 Markdown 文件会成为 LLM 系统提示。研究流水线
GSD Core 在三个层面应对提示注入。
**输入验证(`security.cjs`)。** `get-shit-done/bin/lib/security.cjs` 模块是核心安全工具。它提供:
**输入验证(`security.cjs`)。** `gsd-core/bin/lib/security.cjs` 模块是核心安全工具。它提供:
- 路径遍历防护:用户提供的文件路径(`--text-file`、`--prd`)经过验证,确保解析在项目目录内,并显式处理 macOS `/var` → `/private/var` 符号链接解析
- 提示注入检测:已知注入模式(角色覆盖、指令绕过、系统标签注入)在用户提供的文本进入任何规划产物之前进行扫描

View File

@@ -89,19 +89,19 @@ GSD 的设计围绕全新上下文展开。每个子代理已获得干净的 200
这会产生警告 `W002`。使用状态 CLI 进行诊断和修复:
```bash
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state validate
node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state validate
```
在不写入的情况下预览同步将更改的内容:
```bash
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync --verify
node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync --verify
```
应用同步:
```bash
node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" state sync
node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" state sync
```
这些命令从磁盘上的实际项目状态重建 `STATE.md`,取代手动编辑 `STATE.md` 的操作。

View File

@@ -14,7 +14,7 @@
示例:`.planning/phases/03-post-feed/03-CONTEXT.md`。
该文件由 `get-shit-done/workflows/discuss-phase.md` 中的 `write_context` 步骤生成(或通过 PRD/ADR 摄入快速路径生成)。在正常操作中,该文件不会被手动编辑——讨论阶段工作流负责写入,下游代理将其作为封闭的可信来源读取。
该文件由 `gsd-core/workflows/discuss-phase.md` 中的 `write_context` 步骤生成(或通过 PRD/ADR 摄入快速路径生成)。在正常操作中,该文件不会被手动编辑——讨论阶段工作流负责写入,下游代理将其作为封闭的可信来源读取。
---

View File

@@ -122,8 +122,8 @@ Output: PostFeed and PostCard components wired to /api/feed.
```xml
<execution_context>
@~/.claude/get-shit-done/workflows/execute-plan.md
@~/.claude/get-shit-done/templates/summary.md
@~/.claude/gsd-core/workflows/execute-plan.md
@~/.claude/gsd-core/templates/summary.md
</execution_context>
```

View File

@@ -77,7 +77,7 @@ paused_at: null
### 状态值
`get-shit-done/bin/lib/state-document.cjs` 中的 `normalizeStateStatus()` 将原始正文文本映射到以下规范值:
`gsd-core/bin/lib/state-document.cjs` 中的 `normalizeStateStatus()` 将原始正文文本映射到以下规范值:
| 规范值 | 匹配文本(不区分大小写) |
|---|---|
@@ -133,7 +133,7 @@ paused_at: null
## Markdown 正文章节
正文(结束 `---` 之后的所有内容)遵循 `get-shit-done/templates/state.md` 中的模板。标准章节为:
正文(结束 `---` 之后的所有内容)遵循 `gsd-core/templates/state.md` 中的模板。标准章节为:
### 项目参考
@@ -153,7 +153,7 @@ paused_at: null
| `Last activity:` | 处理器写入时为 ISO 日期(`YYYY-MM-DD`);执行器编写时为叙述性文本 |
| `Progress:` | 可视化进度条,如 `[████░░░░░░] 40%` |
当现有值为已知模板默认值时,该章节中的 `Status:` 和 `Last activity:` 字段由 GSD 处理器更新(Knuth 不变式:执行器编写的值被保留)。已知处理器默认值的完整列表位于 `get-shit-done/bin/lib/state-document.cjs` 中的 `KNOWN_TEMPLATE_DEFAULTS`。
当现有值为已知模板默认值时,该章节中的 `Status:` 和 `Last activity:` 字段由 GSD 处理器更新(Knuth 不变式:执行器编写的值被保留)。已知处理器默认值的完整列表位于 `gsd-core/bin/lib/state-document.cjs` 中的 `KNOWN_TEMPLATE_DEFAULTS`。
### 性能指标

View File

@@ -12,7 +12,7 @@ MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"
## 查找表
@~/.claude/get-shit-done/references/model-profiles.md
@~/.claude/gsd-core/references/model-profiles.md
在表中查找已解析配置对应的代理。将 model 参数传递给 Task 调用:

View File

@@ -14,7 +14,7 @@
`find-phase` 命令一步完成规范化和验证:
```bash
PHASE_INFO=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" find-phase "${PHASE}")
PHASE_INFO=$(node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" find-phase "${PHASE}")
```
返回 JSON 包含:
@@ -45,7 +45,7 @@ fi
使用 `roadmap get-phase` 验证阶段存在:
```bash
PHASE_CHECK=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" roadmap get-phase "${PHASE}")
PHASE_CHECK=$(node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" roadmap get-phase "${PHASE}")
if [ "$(printf '%s\n' "$PHASE_CHECK" | jq -r '.found')" = "false" ]; then
echo "ERROR: Phase ${PHASE} not found in roadmap"
exit 1
@@ -57,5 +57,5 @@ fi
使用 `find-phase` 进行目录查找:
```bash
PHASE_DIR=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" find-phase "${PHASE}" --raw)
PHASE_DIR=$(node "$HOME/.claude/gsd-core/bin/gsd-tools.cjs" find-phase "${PHASE}" --raw)
```

View File

@@ -600,7 +600,7 @@ check_substantive() {
关于自动化优先的检查点模式、服务器生命周期管理、CLI 安装处理和错误恢复协议,请参阅:
**@~/.claude/get-shit-done/references/checkpoints.md** → `<automation_reference>` 部分
**@~/.claude/gsd-core/references/checkpoints.md** → `<automation_reference>` 部分
关键原则:
- Claude 在呈现检查点**之前**设置验证环境