@bhargavvc/sdd-cc 1.30.0 → 1.35.0

package/README.zh-CN.md

@@ -1,20 +1,20 @@
 <div align="center">
 
-# GET SHIT DONE
+# SPEC-DRIVEN DEVELOPMENT
 
-[English](README.md) · [Português](README.pt-BR.md) · **简体中文** · [日本語](README.ja-JP.md)
+[English](README.md) · [Português](README.pt-BR.md) · **简体中文** · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
 
-**一个轻量但强大的元提示、上下文工程与规格驱动开发系统，适用于 Claude Code、OpenCode、Gemini CLI、Codex、Copilot、Cursor 和 Antigravity。**
+**一个轻量但强大的元提示、上下文工程与规格驱动开发系统，适用于 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、CodeBuddy 和 Cline。**
 
 **它解决的是 context rot：随着 Claude 的上下文窗口被填满，输出质量逐步劣化的问题。**
 
 [![npm version](https://img.shields.io/npm/v/@bhargavvc/sdd-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@bhargavvc/sdd-cc)
 [![npm downloads](https://img.shields.io/npm/dm/@bhargavvc/sdd-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@bhargavvc/sdd-cc)
-[![Tests](https://img.shields.io/github/actions/workflow/status/gsd-build/sdd/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/gsd-build/sdd/actions/workflows/test.yml)
-[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/sdd)
+[![Tests](https://img.shields.io/github/actions/workflow/status/bhargavvc/sdd-cc/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/bhargavvc/sdd-cc/actions/workflows/test.yml)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
 [![X (Twitter)](https://img.shields.io/badge/X-@sdd__foundation-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/sdd_foundation)
 [![$SDD Token](https://img.shields.io/badge/$SDD-Dexscreener-1C1C1C?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIgZmlsbD0iIzAwRkYwMCIvPjwvc3ZnPg==&logoColor=00FF00)](https://dexscreener.com/solana/dwudwjvan7bzkw9zwlbyv6kspdlvhwzrqy6ebk8xzxkv)
-[![GitHub stars](https://img.shields.io/github/stars/gsd-build/sdd?style=for-the-badge&logo=github&color=181717)](https://github.com/gsd-build/sdd)
+[![GitHub stars](https://img.shields.io/github/stars/bhargavvc/sdd-cc?style=for-the-badge&logo=github&color=181717)](https://github.com/bhargavvc/sdd-cc)
 [![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
 
 <br>
@@ -73,6 +73,16 @@ SDD 解决的就是这个问题。它是让 Claude Code 变得可靠的上下文
 
 适合那些想把自己的需求说明白，然后让系统正确构建出来的人，而不是假装自己在运营一个 50 人工程组织的人。
 
+### v1.32.0 亮点
+
+- **STATE.md 一致性检查** — `state validate` 检测 STATE.md 与文件系统之间的偏差；`state sync` 从实际项目状态重建
+- **`--to N` 标志** — 在完成特定阶段后停止自主执行
+- **研究门控** — 当 RESEARCH.md 有未解决的开放问题时阻止规划
+- **验证里程碑范围过滤** — 后续阶段将处理的差距标记为"延迟"而非差距
+- **读取后编辑保护** — 咨询性 hook 防止非 Claude 运行时的无限重试循环
+- **上下文缩减** — Markdown 截断和缓存友好的 prompt 排序，降低 token 使用量
+- **4 个新运行时** — Trae、Kilo、Augment 和 Cline（共 12 个运行时）
+
 ---
 
 ## 快速开始
@@ -82,18 +92,20 @@ npx @bhargavvc/sdd-cc@latest
 ```
 
 安装器会提示你选择：
-1. **运行时**：Claude Code、OpenCode、Gemini、Codex、Copilot、Cursor、Antigravity，或全部
+1. **运行时**：Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、CodeBuddy、Cline，或全部
 2. **安装位置**：全局（所有项目）或本地（仅当前项目）
 
 安装后可这样验证：
-- Claude Code / Gemini：`/sdd:help`
-- OpenCode：`/sdd-help`
+- Claude Code / Gemini / Copilot / Antigravity：`/sdd-help`
+- OpenCode / Kilo / Augment / Trae / CodeBuddy：`/sdd-help`
 - Codex：`$sdd-help`
-- Copilot：`/sdd:help`
-- Antigravity：`/sdd:help`
+- Cline：SDD 通过 `.clinerules` 安装 — 检查 `.clinerules` 是否存在
 
 > [!NOTE]
-> Codex 安装走的是 skill 机制（`skills/sdd-*/SKILL.md`），不是自定义 prompt。
+> Claude Code 2.1.88+ 和 Codex 以 skill 形式安装（`skills/sdd-*/SKILL.md`）。Cline 使用 `.clinerules`。安装器会自动处理所有格式。
+
+> [!TIP]
+> 基于源码安装或无法使用 npm 的环境，请参阅 **[docs/manual-update.md](docs/manual-update.md)**。
 
 ### 保持更新
 
@@ -111,17 +123,21 @@ npx @bhargavvc/sdd-cc@latest
 npx @bhargavvc/sdd-cc --claude --global   # 安装到 ~/.claude/
 npx @bhargavvc/sdd-cc --claude --local    # 安装到 ./.claude/
 
-# OpenCode（开源，可用免费模型）
+# OpenCode
 npx @bhargavvc/sdd-cc --opencode --global # 安装到 ~/.config/opencode/
 
 # Gemini CLI
 npx @bhargavvc/sdd-cc --gemini --global   # 安装到 ~/.gemini/
 
-# Codex（以 skills 为主）
+# Kilo
+npx @bhargavvc/sdd-cc --kilo --global     # 安装到 ~/.config/kilo/
+npx @bhargavvc/sdd-cc --kilo --local      # 安装到 ./.kilo/
+
+# Codex
 npx @bhargavvc/sdd-cc --codex --global    # 安装到 ~/.codex/
 npx @bhargavvc/sdd-cc --codex --local     # 安装到 ./.codex/
 
-# Copilot（GitHub Copilot CLI）
+# Copilot
 npx @bhargavvc/sdd-cc --copilot --global  # 安装到 ~/.github/
 npx @bhargavvc/sdd-cc --copilot --local   # 安装到 ./.github/
 
@@ -129,16 +145,32 @@ npx @bhargavvc/sdd-cc --copilot --local   # 安装到 ./.github/
 npx @bhargavvc/sdd-cc --cursor --global   # 安装到 ~/.cursor/
 npx @bhargavvc/sdd-cc --cursor --local    # 安装到 ./.cursor/
 
-# Antigravity（Google，以 skills 为主，基于 Gemini）
+# Antigravity
 npx @bhargavvc/sdd-cc --antigravity --global # 安装到 ~/.gemini/antigravity/
 npx @bhargavvc/sdd-cc --antigravity --local  # 安装到 ./.agent/
 
+# Augment
+npx @bhargavvc/sdd-cc --augment --global     # 安装到 ~/.augment/
+npx @bhargavvc/sdd-cc --augment --local      # 安装到 ./.augment/
+
+# Trae
+npx @bhargavvc/sdd-cc --trae --global     # 安装到 ~/.trae/
+npx @bhargavvc/sdd-cc --trae --local      # 安装到 ./.trae/
+
+# CodeBuddy
+npx @bhargavvc/sdd-cc --codebuddy --global # 安装到 ~/.codebuddy/
+npx @bhargavvc/sdd-cc --codebuddy --local  # 安装到 ./.codebuddy/
+
+# Cline
+npx @bhargavvc/sdd-cc --cline --global       # 安装到 ~/.cline/
+npx @bhargavvc/sdd-cc --cline --local        # 安装到 ./.clinerules
+
 # 所有运行时
 npx @bhargavvc/sdd-cc --all --global      # 安装到所有目录
 ```
 
 使用 `--global`（`-g`）或 `--local`（`-l`）可以跳过安装位置提示。
-使用 `--claude`、`--opencode`、`--gemini`、`--codex`、`--copilot`、`--cursor`、`--antigravity` 或 `--all` 可以跳过运行时提示。
+使用 `--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--augment`、`--trae`、`--codebuddy`、`--cline` 或 `--all` 可以跳过运行时提示。
 
 </details>
 
@@ -148,7 +180,7 @@ npx @bhargavvc/sdd-cc --all --global      # 安装到所有目录
 克隆仓库并在本地运行安装器：
 
 ```bash
-git clone https://github.com/gsd-build/sdd.git
+git clone https://github.com/bhargavvc/sdd-cc.git
 cd sdd
 node bin/install.js --claude --local
 ```
@@ -205,12 +237,12 @@ claude --dangerously-skip-permissions
 
 ## 它是怎么工作的
 
-> **已经有现成代码库？** 先运行 `/sdd:map-codebase`。它会并行拉起多个代理分析你的技术栈、架构、约定和风险点。之后 `/sdd:new-project` 就会真正“理解”你的代码库，提问会聚焦在你打算新增的部分，规划时也会自动加载你的现有模式。
+> **已经有现成代码库？** 先运行 `/sdd-map-codebase`。它会并行拉起多个代理分析你的技术栈、架构、约定和风险点。之后 `/sdd-new-project` 就会真正“理解”你的代码库，提问会聚焦在你打算新增的部分，规划时也会自动加载你的现有模式。
 
 ### 1. 初始化项目
 
 ```
-/sdd:new-project
+/sdd-new-project
 ```
 
 一个命令，一条完整流程。系统会：
@@ -229,7 +261,7 @@ claude --dangerously-skip-permissions
 ### 2. 讨论阶段
 
 ```
-/sdd:discuss-phase 1
+/sdd-discuss-phase 1
 ```
 
 **这是你塑造实现方式的地方。**
@@ -257,7 +289,7 @@ claude --dangerously-skip-permissions
 ### 3. 规划阶段
 
 ```
-/sdd:plan-phase 1
+/sdd-plan-phase 1
 ```
 
 系统会：
@@ -275,7 +307,7 @@ claude --dangerously-skip-permissions
 ### 4. 执行阶段
 
 ```
-/sdd:execute-phase 1
+/sdd-execute-phase 1
 ```
 
 系统会：
@@ -326,7 +358,7 @@ claude --dangerously-skip-permissions
 ### 5. 验证工作
 
 ```
-/sdd:verify-work 1
+/sdd-verify-work 1
 ```
 
 **这是你确认它是否真的可用的地方。**
@@ -340,7 +372,7 @@ claude --dangerously-skip-permissions
 3. **自动诊断失败**：拉起 debug 代理定位根因
 4. **创建验证过的修复计划**：可立刻重新执行
 
-如果一切通过，就进入下一步；如果哪里坏了，你不需要手动 debug，只要重新运行 `/sdd:execute-phase`，执行它自动生成的修复计划即可。
+如果一切通过，就进入下一步；如果哪里坏了，你不需要手动 debug，只要重新运行 `/sdd-execute-phase`，执行它自动生成的修复计划即可。
 
 **生成：** `{phase_num}-UAT.md`，以及发现问题时的修复计划
 
@@ -349,38 +381,38 @@ claude --dangerously-skip-permissions
 ### 6. 重复 → 发布 → 完成 → 下一个里程碑
 
 ```
-/sdd:discuss-phase 2
-/sdd:plan-phase 2
-/sdd:execute-phase 2
-/sdd:verify-work 2
-/sdd:ship 2                  # 从已验证的工作创建 PR
+/sdd-discuss-phase 2
+/sdd-plan-phase 2
+/sdd-execute-phase 2
+/sdd-verify-work 2
+/sdd-ship 2                  # 从已验证的工作创建 PR
 ...
-/sdd:complete-milestone
-/sdd:new-milestone
+/sdd-complete-milestone
+/sdd-new-milestone
 ```
 
 或者让 SDD 自动判断下一步：
 
 ```
-/sdd:next                    # 自动检测并执行下一步
+/sdd-next                    # 自动检测并执行下一步
 ```
 
 循环执行 **讨论 → 规划 → 执行 → 验证 → 发布**，直到整个里程碑完成。
 
-如果你希望在讨论阶段更快收集信息，可以用 `/sdd:discuss-phase <n> --batch`，一次回答一小组问题，而不是逐个问答。
+如果你希望在讨论阶段更快收集信息，可以用 `/sdd-discuss-phase <n> --batch`，一次回答一小组问题，而不是逐个问答。
 
 每个阶段都会得到你的输入（discuss）、充分研究（plan）、干净执行（execute）和人工验证（verify）。上下文始终保持新鲜，质量也能持续稳定。
 
-当所有阶段完成后，`/sdd:complete-milestone` 会归档当前里程碑并打 release tag。
+当所有阶段完成后，`/sdd-complete-milestone` 会归档当前里程碑并打 release tag。
 
-接着用 `/sdd:new-milestone` 开启下一个版本。它和 `new-project` 流程相同，只是面向你现有的代码库。你描述下一步想构建什么，系统研究领域、梳理需求，再产出新的路线图。每个里程碑都是一个干净周期：定义 → 构建 → 发布。
+接着用 `/sdd-new-milestone` 开启下一个版本。它和 `new-project` 流程相同，只是面向你现有的代码库。你描述下一步想构建什么，系统研究领域、梳理需求，再产出新的路线图。每个里程碑都是一个干净周期：定义 → 构建 → 发布。
 
 ---
 
 ### 快速模式
 
 ```
-/sdd:quick
+/sdd-quick
 ```
 
 **适用于不需要完整规划的临时任务。**
@@ -400,7 +432,7 @@ claude --dangerously-skip-permissions
 参数可组合使用：`--discuss --research --full` 可同时获得讨论 + 研究 + 计划检查 + 验证。
 
 ```
-/sdd:quick
+/sdd-quick
 > What do you want to do? "Add dark mode toggle to settings"
 ```
 
@@ -497,107 +529,107 @@ lmn012o feat(08-02): create registration endpoint
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 |
-| `/sdd:discuss-phase [N] [--auto] [--analyze]` | 在规划前收集实现决策（`--analyze` 增加权衡分析） |
-| `/sdd:plan-phase [N] [--auto] [--reviews]` | 为某个阶段执行研究 + 规划 + 验证（`--reviews` 加载代码库审查结果） |
-| `/sdd:execute-phase <N>` | 以并行 wave 执行全部计划，完成后验证 |
-| `/sdd:verify-work [N]` | 人工用户验收测试 ¹ |
-| `/sdd:ship [N] [--draft]` | 从已验证的阶段工作创建 PR，自动生成 PR 描述 |
-| `/sdd:fast <text>` | 内联处理琐碎任务——完全跳过规划，立即执行 |
-| `/sdd:next` | 自动推进到下一个逻辑工作流步骤 |
-| `/sdd:audit-milestone` | 验证里程碑是否达到完成定义 |
-| `/sdd:complete-milestone` | 归档里程碑并打 release tag |
-| `/sdd:new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 |
-| `/sdd:milestone-summary` | 从已完成的里程碑产物生成项目概览，用于团队上手 |
-| `/sdd:forensics` | 对失败或卡住的工作流进行事后调查 |
+| `/sdd-new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 |
+| `/sdd-discuss-phase [N] [--auto] [--analyze]` | 在规划前收集实现决策（`--analyze` 增加权衡分析） |
+| `/sdd-plan-phase [N] [--auto] [--reviews]` | 为某个阶段执行研究 + 规划 + 验证（`--reviews` 加载代码库审查结果） |
+| `/sdd-execute-phase <N>` | 以并行 wave 执行全部计划，完成后验证 |
+| `/sdd-verify-work [N]` | 人工用户验收测试 ¹ |
+| `/sdd-ship [N] [--draft]` | 从已验证的阶段工作创建 PR，自动生成 PR 描述 |
+| `/sdd-fast <text>` | 内联处理琐碎任务——完全跳过规划，立即执行 |
+| `/sdd-next` | 自动推进到下一个逻辑工作流步骤 |
+| `/sdd-audit-milestone` | 验证里程碑是否达到完成定义 |
+| `/sdd-complete-milestone` | 归档里程碑并打 release tag |
+| `/sdd-new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 |
+| `/sdd-milestone-summary` | 从已完成的里程碑产物生成项目概览，用于团队上手 |
+| `/sdd-forensics` | 对失败或卡住的工作流进行事后调查 |
 
 ### 工作流（Workstreams）
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:workstreams list` | 显示所有工作流及其状态 |
-| `/sdd:workstreams create <name>` | 创建命名空间工作流，用于并行里程碑工作 |
-| `/sdd:workstreams switch <name>` | 切换当前活跃工作流 |
-| `/sdd:workstreams complete <name>` | 完成并合并工作流 |
+| `/sdd-workstreams list` | 显示所有工作流及其状态 |
+| `/sdd-workstreams create <name>` | 创建命名空间工作流，用于并行里程碑工作 |
+| `/sdd-workstreams switch <name>` | 切换当前活跃工作流 |
+| `/sdd-workstreams complete <name>` | 完成并合并工作流 |
 
 ### 多项目工作区
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:new-workspace` | 创建隔离工作区，包含仓库副本（worktree 或 clone） |
-| `/sdd:list-workspaces` | 显示所有 SDD 工作区及其状态 |
-| `/sdd:remove-workspace` | 移除工作区并清理 worktree |
+| `/sdd-new-workspace` | 创建隔离工作区，包含仓库副本（worktree 或 clone） |
+| `/sdd-list-workspaces` | 显示所有 SDD 工作区及其状态 |
+| `/sdd-remove-workspace` | 移除工作区并清理 worktree |
 
 ### UI 设计
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:ui-phase [N]` | 为前端阶段生成 UI 设计合约（UI-SPEC.md） |
-| `/sdd:ui-review [N]` | 对已实现前端代码进行 6 维视觉审计 |
+| `/sdd-ui-phase [N]` | 为前端阶段生成 UI 设计合约（UI-SPEC.md） |
+| `/sdd-ui-review [N]` | 对已实现前端代码进行 6 维视觉审计 |
 
 ### 导航
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:progress` | 我现在在哪？下一步是什么？ |
-| `/sdd:next` | 自动检测状态并执行下一步 |
-| `/sdd:help` | 显示全部命令和使用指南 |
-| `/sdd:update` | 更新 GSD，并预览变更日志 |
-| `/sdd:join-discord` | 加入 SDD Discord 社区 |
+| `/sdd-progress` | 我现在在哪？下一步是什么？ |
+| `/sdd-next` | 自动检测状态并执行下一步 |
+| `/sdd-help` | 显示全部命令和使用指南 |
+| `/sdd-update` | 更新 GSD，并预览变更日志 |
+| `/sdd-join-discord` | 加入 SDD Discord 社区 |
 
 ### Brownfield
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:map-codebase` | 在 `new-project` 前分析现有代码库 |
+| `/sdd-map-codebase` | 在 `new-project` 前分析现有代码库 |
 
 ### 阶段管理
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:add-phase` | 在路线图末尾追加 phase |
-| `/sdd:insert-phase [N]` | 在 phase 之间插入紧急工作 |
-| `/sdd:remove-phase [N]` | 删除未来 phase，并重编号 |
-| `/sdd:list-phase-assumptions [N]` | 在规划前查看 Claude 打算采用的方案 |
-| `/sdd:plan-milestone-gaps` | 为 audit 发现的缺口创建 phase |
+| `/sdd-add-phase` | 在路线图末尾追加 phase |
+| `/sdd-insert-phase [N]` | 在 phase 之间插入紧急工作 |
+| `/sdd-remove-phase [N]` | 删除未来 phase，并重编号 |
+| `/sdd-list-phase-assumptions [N]` | 在规划前查看 Claude 打算采用的方案 |
+| `/sdd-plan-milestone-gaps` | 为 audit 发现的缺口创建 phase |
 
 ### 代码质量
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:review` | 对当前阶段或分支进行跨 AI 同行评审 |
-| `/sdd:pr-branch` | 创建过滤 `.planning/` 提交的干净 PR 分支 |
-| `/sdd:audit-uat` | 审计验证债务——找出缺少 UAT 的阶段 |
+| `/sdd-review` | 对当前阶段或分支进行跨 AI 同行评审 |
+| `/sdd-pr-branch` | 创建过滤 `.planning/` 提交的干净 PR 分支 |
+| `/sdd-audit-uat` | 审计验证债务——找出缺少 UAT 的阶段 |
 
 ### 积压
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:plant-seed <idea>` | 将想法存入积压停车场，留待未来里程碑 |
+| `/sdd-plant-seed <idea>` | 将想法存入积压停车场，留待未来里程碑 |
 
 ### 会话
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:pause-work` | 在中途暂停时创建交接上下文（写入 HANDOFF.json） |
-| `/sdd:resume-work` | 从上一次会话恢复 |
-| `/sdd:session-report` | 生成会话摘要，包含已完成工作和结果 |
+| `/sdd-pause-work` | 在中途暂停时创建交接上下文（写入 HANDOFF.json） |
+| `/sdd-resume-work` | 从上一次会话恢复 |
+| `/sdd-session-report` | 生成会话摘要，包含已完成工作和结果 |
 
 ### 工具
 
 | 命令 | 作用 |
 |------|------|
-| `/sdd:settings` | 配置模型 profile 和工作流代理 |
-| `/sdd:set-profile <profile>` | 切换模型 profile（quality / balanced / budget / inherit） |
-| `/sdd:add-todo [desc]` | 记录一个待办想法 |
-| `/sdd:check-todos` | 查看待办列表 |
-| `/sdd:debug [desc]` | 使用持久状态进行系统化调试 |
-| `/sdd:do <text>` | 将自由文本自动路由到正确的 SDD 命令 |
-| `/sdd:note <text>` | 零摩擦想法捕捉——追加、列出或提升为待办 |
-| `/sdd:quick [--full] [--discuss] [--research]` | 以 SDD 保障执行临时任务（`--full` 增加计划检查和验证，`--discuss` 先补上下文，`--research` 在规划前先调研） |
-| `/sdd:health [--repair]` | 校验 `.planning/` 目录完整性，带 `--repair` 时自动修复 |
-| `/sdd:stats` | 显示项目统计——阶段、计划、需求、git 指标 |
-| `/sdd:profile-user [--questionnaire] [--refresh]` | 从会话分析生成开发者行为档案，用于个性化响应 |
+| `/sdd-settings` | 配置模型 profile 和工作流代理 |
+| `/sdd-set-profile <profile>` | 切换模型 profile（quality / balanced / budget / inherit） |
+| `/sdd-add-todo [desc]` | 记录一个待办想法 |
+| `/sdd-check-todos` | 查看待办列表 |
+| `/sdd-debug [desc]` | 使用持久状态进行系统化调试 |
+| `/sdd-do <text>` | 将自由文本自动路由到正确的 SDD 命令 |
+| `/sdd-note <text>` | 零摩擦想法捕捉——追加、列出或提升为待办 |
+| `/sdd-quick [--full] [--discuss] [--research]` | 以 SDD 保障执行临时任务（`--full` 增加计划检查和验证，`--discuss` 先补上下文，`--research` 在规划前先调研） |
+| `/sdd-health [--repair]` | 校验 `.planning/` 目录完整性，带 `--repair` 时自动修复 |
+| `/sdd-stats` | 显示项目统计——阶段、计划、需求、git 指标 |
+| `/sdd-profile-user [--questionnaire] [--refresh]` | 从会话分析生成开发者行为档案，用于个性化响应 |
 
 <sup>¹ 由 reddit 用户 OracleGreyBeard 贡献</sup>
 
@@ -605,7 +637,7 @@ lmn012o feat(08-02): create registration endpoint
 
 ## 配置
 
-SDD 将项目设置保存在 `.planning/config.json`。你可以在 `/sdd:new-project` 时配置，也可以稍后通过 `/sdd:settings` 修改。完整的配置 schema、工作流开关、git branching 选项以及各代理的模型分配，请查看[用户指南](docs/USER-GUIDE.md#configuration-reference)。
+SDD 将项目设置保存在 `.planning/config.json`。你可以在 `/sdd-new-project` 时配置，也可以稍后通过 `/sdd-settings` 修改。完整的配置 schema、工作流开关、git branching 选项以及各代理的模型分配，请查看[用户指南](docs/USER-GUIDE.md#configuration-reference)。
 
 ### 核心设置
 
@@ -627,12 +659,12 @@ SDD 将项目设置保存在 `.planning/config.json`。你可以在 `/sdd:new-pr
 
 切换方式：
 ```
-/sdd:set-profile budget
+/sdd-set-profile budget
 ```
 
 使用非 Anthropic 提供商（OpenRouter、本地模型）时，或想跟随当前运行时的模型选择时（如 OpenCode 的 `/model`），可用 `inherit`。
 
-也可以通过 `/sdd:settings` 配置。
+也可以通过 `/sdd-settings` 配置。
 
 ### 工作流代理
 
@@ -648,9 +680,9 @@ SDD 将项目设置保存在 `.planning/config.json`。你可以在 `/sdd:new-pr
 | `workflow.skip_discuss` | `false` | 在自主模式下完全跳过讨论阶段 |
 | `workflow.discuss_mode` | `null` | 控制讨论阶段行为（`assumptions` 使用推断默认值） |
 
-可以用 `/sdd:settings` 开关这些项，也可以在单次命令里覆盖：
-- `/sdd:plan-phase --skip-research`
-- `/sdd:plan-phase --skip-verify`
+可以用 `/sdd-settings` 开关这些项，也可以在单次命令里覆盖：
+- `/sdd-plan-phase --skip-research`
+- `/sdd-plan-phase --skip-verify`
 
 ### 执行
 
@@ -718,7 +750,7 @@ SDD 的代码库映射和分析命令会读取文件来理解你的项目。**
 - 对 Codex，检查 skills 是否存在于 `~/.codex/skills/sdd-*/SKILL.md`（全局）或 `./.codex/skills/sdd-*/SKILL.md`（本地）
 
 **命令行为不符合预期？**
-- 运行 `/sdd:help` 确认安装成功
+- 运行 `/sdd-help` 确认安装成功
 - 重新执行 `npx @bhargavvc/sdd-cc` 进行重装
 
 **想更新到最新版本？**
@@ -743,19 +775,27 @@ CLAUDE_CONFIG_DIR=/home/youruser/.claude npx @bhargavvc/sdd-cc --global
 npx @bhargavvc/sdd-cc --claude --global --uninstall
 npx @bhargavvc/sdd-cc --opencode --global --uninstall
 npx @bhargavvc/sdd-cc --gemini --global --uninstall
+npx @bhargavvc/sdd-cc --kilo --global --uninstall
 npx @bhargavvc/sdd-cc --codex --global --uninstall
 npx @bhargavvc/sdd-cc --copilot --global --uninstall
 npx @bhargavvc/sdd-cc --cursor --global --uninstall
 npx @bhargavvc/sdd-cc --antigravity --global --uninstall
+npx @bhargavvc/sdd-cc --augment --global --uninstall
+npx @bhargavvc/sdd-cc --trae --global --uninstall
+npx @bhargavvc/sdd-cc --cline --global --uninstall
 
 # 本地安装（当前项目）
 npx @bhargavvc/sdd-cc --claude --local --uninstall
 npx @bhargavvc/sdd-cc --opencode --local --uninstall
 npx @bhargavvc/sdd-cc --gemini --local --uninstall
+npx @bhargavvc/sdd-cc --kilo --local --uninstall
 npx @bhargavvc/sdd-cc --codex --local --uninstall
 npx @bhargavvc/sdd-cc --copilot --local --uninstall
 npx @bhargavvc/sdd-cc --cursor --local --uninstall
 npx @bhargavvc/sdd-cc --antigravity --local --uninstall
+npx @bhargavvc/sdd-cc --augment --local --uninstall
+npx @bhargavvc/sdd-cc --trae --local --uninstall
+npx @bhargavvc/sdd-cc --cline --local --uninstall
 ```
 
 这会移除所有 SDD 命令、代理、hooks 和设置，但会保留你其他配置。
@@ -764,7 +804,7 @@ npx @bhargavvc/sdd-cc --antigravity --local --uninstall
 
 ## 社区移植版本
 
-OpenCode、Gemini CLI 和 Codex 现在都已经通过 `npx @bhargavvc/sdd-cc` 获得原生支持。
+OpenCode、Gemini CLI、Kilo 和 Codex 现在都已经通过 `npx @bhargavvc/sdd-cc` 获得原生支持。
 
 这些社区移植版本曾率先探索多运行时支持：
 
@@ -777,11 +817,11 @@ OpenCode、Gemini CLI 和 Codex 现在都已经通过 `npx @bhargavvc/sdd-cc`
 
 ## Star History
 
-<a href="https://star-history.com/#gsd-build/sdd&Date">
+<a href="https://star-history.com/#bhargavvc/sdd-cc&Date">
  <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=gsd-build/sdd&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=gsd-build/sdd&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=gsd-build/sdd&type=Date" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bhargavvc/sdd-cc&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bhargavvc/sdd-cc&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=bhargavvc/sdd-cc&type=Date" />
  </picture>
 </a>
 

package/agents/sdd-advisor-researcher.md

@@ -17,6 +17,29 @@ Spawned by `discuss-phase` via `Task()`. You do NOT present output directly to t
 - Return structured markdown output for the main agent to synthesize
 </role>
 
+<documentation_lookup>
+When you need library or framework documentation, check in this order:
+
+1. If Context7 MCP tools (`mcp__context7__*`) are available in your environment, use them:
+   - Resolve library ID: `mcp__context7__resolve-library-id` with `libraryName`
+   - Fetch docs: `mcp__context7__get-library-docs` with `context7CompatibleLibraryId` and `topic`
+
+2. If Context7 MCP is not available (upstream bug anthropics/claude-code#13898 strips MCP
+   tools from agents with a `tools:` frontmatter restriction), use the CLI fallback via Bash:
+
+   Step 1 — Resolve library ID:
+   ```bash
+   npx --yes ctx7@latest library <name> "<query>"
+   ```
+   Step 2 — Fetch documentation:
+   ```bash
+   npx --yes ctx7@latest docs <libraryId> "<query>"
+   ```
+
+Do not skip documentation lookups because MCP tools are unavailable — the CLI fallback
+works via Bash and produces equivalent output.
+</documentation_lookup>
+
 <input>
 Agent receives via prompt: