mirror of
https://github.com/glittercowboy/get-shit-done
synced 2026-04-25 17:25:23 +02:00
fix: replace /gsd: slash command format with /gsd- skill format in all user-facing content (#1579)
* fix: replace /gsd: command format with /gsd- skill format in all suggestions All next-step suggestions shown to users were still using the old colon format (/gsd:xxx) which cannot be copy-pasted as skills. Migrated all occurrences across agents/, commands/, get-shit-done/, docs/, README files, bin/install.js (hardcoded defaults for claude runtime), and get-shit-done/bin/lib/*.cjs (generate-claude-md templates and error messages). Updated tests to assert new hyphen format instead of old colon format. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: migrate remaining /gsd: format to /gsd- in hooks, workflows, and sdk Addresses remaining user-facing occurrences missed in the initial migration: - hooks/: fix 4 user-facing messages (pause-work, update, fast, quick) and 2 comments in gsd-workflow-guard.js - get-shit-done/workflows/: fix 21 Skill() literal calls that Claude executes directly (installer does not transform workflow content) - sdk/prompt-sanitizer.ts: update regex to strip /gsd- format in addition to legacy /gsd: format; update JSDoc comment - tests/: update autonomous-ui-steps, prompt-sanitizer to assert new format Note: commands/gsd/*.md frontmatter (name: gsd:xxx) intentionally unchanged — installer derives skillName from directory path, not the name field. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(plan-phase): preserve --chain flag in auto-advance sync and handle ui-phase gate in chain mode Bug 1: step 15 sync-flag check only guarded against --auto, causing _auto_chain_active to be cleared when plan-phase is invoked without --auto in ARGUMENTS even though a --chain pipeline was active. Added --chain to the guard condition, matching discuss-phase behaviour. Bug 2: UI Design Contract gate (step 5.6) always exited the workflow when UI-SPEC was missing, breaking the discuss --chain pipeline silently. When _auto_chain_active is true, the gate now auto-invokes gsd-ui-phase --auto via Skill() and continues to step 6 without prompting. Manual invocations retain the existing AskUserQuestion flow. * fix: remove <sub>/clear</sub> pattern and duplicate old-format command in discuss-phase.md --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -86,7 +86,7 @@ npx get-shit-done-cc@latest
|
||||
2. **位置** —— 全局(所有项目)或本地(仅当前项目)
|
||||
|
||||
验证安装:
|
||||
- Claude Code / Gemini: `/gsd:help`
|
||||
- Claude Code / Gemini: `/gsd-help`
|
||||
- OpenCode: `/gsd-help`
|
||||
- Kilo: `/gsd-help`
|
||||
- Codex: `$gsd-help`
|
||||
@@ -196,12 +196,12 @@ claude --dangerously-skip-permissions
|
||||
|
||||
## 工作原理
|
||||
|
||||
> **已有代码?** 先运行 `/gsd:map-codebase`。它会生成并行代理分析你的技术栈、架构、约定和关注点。然后 `/gsd:new-project` 就了解你的代码库了 —— 问题聚焦在你正在**添加**什么,规划会自动加载你的模式。
|
||||
> **已有代码?** 先运行 `/gsd-map-codebase`。它会生成并行代理分析你的技术栈、架构、约定和关注点。然后 `/gsd-new-project` 就了解你的代码库了 —— 问题聚焦在你正在**添加**什么,规划会自动加载你的模式。
|
||||
|
||||
### 1. 初始化项目
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
一条命令,一个流程。系统:
|
||||
@@ -220,7 +220,7 @@ claude --dangerously-skip-permissions
|
||||
### 2. 讨论阶段
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
**这是你塑造实现方式的地方。**
|
||||
@@ -248,7 +248,7 @@ claude --dangerously-skip-permissions
|
||||
### 3. 规划阶段
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
系统:
|
||||
@@ -266,7 +266,7 @@ claude --dangerously-skip-permissions
|
||||
### 4. 执行阶段
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
系统:
|
||||
@@ -317,7 +317,7 @@ claude --dangerously-skip-permissions
|
||||
### 5. 验证工作
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
**这是你确认它真的有效的地方。**
|
||||
@@ -331,7 +331,7 @@ claude --dangerously-skip-permissions
|
||||
3. **自动诊断失败** —— 生成调试代理找根本原因
|
||||
4. **创建已验证的修复计划** —— 准备立即重新执行
|
||||
|
||||
如果一切通过,继续。如果有东西坏了,不用手动调试 —— 只需再次运行 `/gsd:execute-phase`,使用它创建的修复计划。
|
||||
如果一切通过,继续。如果有东西坏了,不用手动调试 —— 只需再次运行 `/gsd-execute-phase`,使用它创建的修复计划。
|
||||
|
||||
**创建:** `{阶段号}-UAT.md`,如果发现问题则创建修复计划
|
||||
|
||||
@@ -340,31 +340,31 @@ claude --dangerously-skip-permissions
|
||||
### 6. 循环 → 完成 → 下一个里程碑
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
...
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
循环 **讨论 → 规划 → 执行 → 验证** 直到里程碑完成。
|
||||
|
||||
如果你想在讨论期间更快速地输入,使用 `/gsd:discuss-phase <n> --batch` 一次回答一组小问题,而不是一个一个来。使用 `--chain` 可以自动链式执行从讨论到规划+执行,中间不停顿。
|
||||
如果你想在讨论期间更快速地输入,使用 `/gsd-discuss-phase <n> --batch` 一次回答一组小问题,而不是一个一个来。使用 `--chain` 可以自动链式执行从讨论到规划+执行,中间不停顿。
|
||||
|
||||
每个阶段都会获得你的输入(讨论)、适当的研究(规划)、干净的执行(执行)和人工验证(验证)。上下文保持新鲜。质量保持高水平。
|
||||
|
||||
当所有阶段完成后,`/gsd:complete-milestone` 归档里程碑并标记发布。
|
||||
当所有阶段完成后,`/gsd-complete-milestone` 归档里程碑并标记发布。
|
||||
|
||||
然后 `/gsd:new-milestone` 开始下一个版本 —— 与 `new-project` 相同的流程,但针对你现有的代码库。你描述接下来想构建什么,系统研究领域,你界定需求范围,它创建新的路线图。每个里程碑是一个干净的周期:定义 → 构建 → 发布。
|
||||
然后 `/gsd-new-milestone` 开始下一个版本 —— 与 `new-project` 相同的流程,但针对你现有的代码库。你描述接下来想构建什么,系统研究领域,你界定需求范围,它创建新的路线图。每个里程碑是一个干净的周期:定义 → 构建 → 发布。
|
||||
|
||||
---
|
||||
|
||||
### 快速模式
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
**用于不需要完整规划的临时任务。**
|
||||
@@ -386,7 +386,7 @@ claude --dangerously-skip-permissions
|
||||
标志可组合:`--discuss --research --validate` 提供讨论 + 研究 + 计划检查 + 验证。
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> 你想做什么?"在设置中添加深色模式切换"
|
||||
```
|
||||
|
||||
@@ -483,58 +483,58 @@ lmn012o feat(08-02): 创建注册端点
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:new-project [--auto]` | 完整初始化:提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--chain]` | 在规划前捕获实现决策(`--chain` 自动链式执行规划+执行) |
|
||||
| `/gsd:plan-phase [N] [--auto]` | 阶段的研究 + 规划 + 验证 |
|
||||
| `/gsd:execute-phase <N>` | 在并行波次中执行所有计划,完成后验证 |
|
||||
| `/gsd:verify-work [N]` | 手动用户验收测试 ¹ |
|
||||
| `/gsd:audit-milestone` | 验证里程碑达到了其完成定义 |
|
||||
| `/gsd:complete-milestone` | 归档里程碑,标记发布 |
|
||||
| `/gsd:new-milestone [name]` | 开始下一个版本:提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd-new-project [--auto]` | 完整初始化:提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--chain]` | 在规划前捕获实现决策(`--chain` 自动链式执行规划+执行) |
|
||||
| `/gsd-plan-phase [N] [--auto]` | 阶段的研究 + 规划 + 验证 |
|
||||
| `/gsd-execute-phase <N>` | 在并行波次中执行所有计划,完成后验证 |
|
||||
| `/gsd-verify-work [N]` | 手动用户验收测试 ¹ |
|
||||
| `/gsd-audit-milestone` | 验证里程碑达到了其完成定义 |
|
||||
| `/gsd-complete-milestone` | 归档里程碑,标记发布 |
|
||||
| `/gsd-new-milestone [name]` | 开始下一个版本:提问 → 研究 → 需求 → 路线图 |
|
||||
|
||||
### 导航
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:progress` | 我在哪?接下来做什么? |
|
||||
| `/gsd:help` | 显示所有命令和使用指南 |
|
||||
| `/gsd:update` | 更新 GSD 并预览变更日志 |
|
||||
| `/gsd:join-discord` | 加入 GSD Discord 社区 |
|
||||
| `/gsd-progress` | 我在哪?接下来做什么? |
|
||||
| `/gsd-help` | 显示所有命令和使用指南 |
|
||||
| `/gsd-update` | 更新 GSD 并预览变更日志 |
|
||||
| `/gsd-join-discord` | 加入 GSD Discord 社区 |
|
||||
|
||||
### 现有代码库
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:map-codebase` | 在 new-project 之前分析现有代码库 |
|
||||
| `/gsd-map-codebase` | 在 new-project 之前分析现有代码库 |
|
||||
|
||||
### 阶段管理
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:add-phase` | 向路线图追加阶段 |
|
||||
| `/gsd:insert-phase [N]` | 在阶段之间插入紧急工作 |
|
||||
| `/gsd:remove-phase [N]` | 删除未来阶段,重新编号 |
|
||||
| `/gsd:list-phase-assumptions [N]` | 规划前查看 Claude 的预期方法 |
|
||||
| `/gsd:plan-milestone-gaps` | 创建阶段以填补审计发现的差距 |
|
||||
| `/gsd-add-phase` | 向路线图追加阶段 |
|
||||
| `/gsd-insert-phase [N]` | 在阶段之间插入紧急工作 |
|
||||
| `/gsd-remove-phase [N]` | 删除未来阶段,重新编号 |
|
||||
| `/gsd-list-phase-assumptions [N]` | 规划前查看 Claude 的预期方法 |
|
||||
| `/gsd-plan-milestone-gaps` | 创建阶段以填补审计发现的差距 |
|
||||
|
||||
### 会话
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:pause-work` | 阶段中途停止时创建交接 |
|
||||
| `/gsd:resume-work` | 从上次会话恢复 |
|
||||
| `/gsd-pause-work` | 阶段中途停止时创建交接 |
|
||||
| `/gsd-resume-work` | 从上次会话恢复 |
|
||||
|
||||
### 工具
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:settings` | 配置模型配置文件和工作流代理 |
|
||||
| `/gsd:set-profile <profile>` | 切换模型配置文件(quality/balanced/budget) |
|
||||
| `/gsd:add-todo [desc]` | 捕获想法留待后用 |
|
||||
| `/gsd:check-todos` | 列出待处理事项 |
|
||||
| `/gsd:debug [desc]` | 带持久状态的系统化调试 |
|
||||
| `/gsd:quick [--full] [--discuss] [--research]` | 用 GSD 保证执行临时任务(`--full` 启用全部阶段,`--discuss` 先收集上下文,`--research` 规划前调查方法) |
|
||||
| `/gsd:health [--repair]` | 验证 `.planning/` 目录完整性,用 `--repair` 自动修复 |
|
||||
| `/gsd-settings` | 配置模型配置文件和工作流代理 |
|
||||
| `/gsd-set-profile <profile>` | 切换模型配置文件(quality/balanced/budget) |
|
||||
| `/gsd-add-todo [desc]` | 捕获想法留待后用 |
|
||||
| `/gsd-check-todos` | 列出待处理事项 |
|
||||
| `/gsd-debug [desc]` | 带持久状态的系统化调试 |
|
||||
| `/gsd-quick [--full] [--discuss] [--research]` | 用 GSD 保证执行临时任务(`--full` 启用全部阶段,`--discuss` 先收集上下文,`--research` 规划前调查方法) |
|
||||
| `/gsd-health [--repair]` | 验证 `.planning/` 目录完整性,用 `--repair` 自动修复 |
|
||||
|
||||
<sup>¹ 由 Reddit 用户 OracleGreyBeard 贡献</sup>
|
||||
|
||||
@@ -542,7 +542,7 @@ lmn012o feat(08-02): 创建注册端点
|
||||
|
||||
## 配置
|
||||
|
||||
GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project` 期间配置或稍后用 `/gsd:settings` 更新。完整配置模式、工作流开关、git 分支选项和每个代理的模型分解,请参阅[用户指南](USER-GUIDE.md#配置参考)。
|
||||
GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd-new-project` 期间配置或稍后用 `/gsd-settings` 更新。完整配置模式、工作流开关、git 分支选项和每个代理的模型分解,请参阅[用户指南](USER-GUIDE.md#配置参考)。
|
||||
|
||||
### 核心设置
|
||||
|
||||
@@ -563,10 +563,10 @@ GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project`
|
||||
|
||||
切换配置:
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
或通过 `/gsd:settings` 配置。
|
||||
或通过 `/gsd-settings` 配置。
|
||||
|
||||
### 工作流代理
|
||||
|
||||
@@ -579,9 +579,9 @@ GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project`
|
||||
| `workflow.verifier` | `true` | 执行后确认必须项已交付 |
|
||||
| `workflow.auto_advance` | `false` | 自动链式执行 讨论 → 规划 → 执行 |
|
||||
|
||||
使用 `/gsd:settings` 切换这些,或每次调用时覆盖:
|
||||
- `/gsd:plan-phase --skip-research`
|
||||
- `/gsd:plan-phase --skip-verify`
|
||||
使用 `/gsd-settings` 切换这些,或每次调用时覆盖:
|
||||
- `/gsd-plan-phase --skip-research`
|
||||
- `/gsd-plan-phase --skip-verify`
|
||||
|
||||
### 执行
|
||||
|
||||
@@ -648,7 +648,7 @@ GSD 的代码库映射和分析命令读取文件以了解你的项目。**保
|
||||
- 对于 Codex,验证技能是否存在于 `~/.codex/skills/gsd-*/SKILL.md`(全局)或 `./.codex/skills/gsd-*/SKILL.md`(本地)
|
||||
|
||||
**命令没有按预期工作?**
|
||||
- 运行 `/gsd:help` 验证安装
|
||||
- 运行 `/gsd-help` 验证安装
|
||||
- 重新运行 `npx get-shit-done-cc` 重新安装
|
||||
|
||||
**更新到最新版本?**
|
||||
|
||||
Reference in New Issue
Block a user