refactor: hard-fork GSD -> MSD (Make Software Done)
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
This commit is contained in:
Jakub Zych
@@ -2,7 +2,7 @@
|
||||
|
||||
**目标：** 在某个阶段执行失败、卡住或产生不完整工作时进行恢复，并在不丢失进度或重复已成功工作的情况下干净地继续。
|
||||
|
||||
**前提条件：** 您已运行 `/gsd-execute-phase N`，执行在写入 `VERIFICATION.md` 之前停止，或者您看到意外输出、缺少文件，或进度条卡住不动。
|
||||
**前提条件：** 您已运行 `/msd-execute-phase N`，执行在写入 `VERIFICATION.md` 之前停止，或者您看到意外输出、缺少文件，或进度条卡住不动。
|
||||
|
||||
---
|
||||
|
||||
@@ -12,15 +12,15 @@
|
||||
|
||||
### 如果您看到"Spawning…"后超过 1–5 分钟没有输出
|
||||
|
||||
这是正常现象，并非冻结。GSD 子代理在独立的上下文窗口中运行。spawn 行上的存活注释可以确认这一点。请不要中断会话。
|
||||
这是正常现象，并非冻结。MSD 子代理在独立的上下文窗口中运行。spawn 行上的存活注释可以确认这一点。请不要中断会话。
|
||||
|
||||
如果超过 10 分钟仍无结果，请检查 Claude Code 侧边栏。如果代理任务显示已完成但没有输出，结果可能在上下文切换中丢失——请重新运行相同的命令：
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1
|
||||
/msd-execute-phase 1
|
||||
```
|
||||
|
||||
GSD 在分派执行器之前会检查 `SUMMARY.md` 文件。已有该文件的计划将被自动跳过。
|
||||
MSD 在分派执行器之前会检查 `SUMMARY.md` 文件。已有该文件的计划将被自动跳过。
|
||||
|
||||
### 如果执行在某个 wave 中途停止并显示错误信息
|
||||
|
||||
@@ -34,7 +34,7 @@ git log --oneline -20
|
||||
|
||||
### 如果执行器已提交代码但未写入 SUMMARY.md
|
||||
|
||||
GSD 会在下次运行时检测到这一情况，并弹出一个安全恢复确认界面，提供三个选项：
|
||||
MSD 会在下次运行时检测到这一情况，并弹出一个安全恢复确认界面，提供三个选项：
|
||||
|
||||
- **手动收尾** — 自行检查提交内容，写入 `SUMMARY.md`，然后重新运行。
|
||||
- **从头重新执行** — 在分派新执行器之前，回滚或覆盖部分提交。
|
||||
@@ -44,12 +44,12 @@ GSD 会在下次运行时检测到这一情况，并弹出一个安全恢复确
|
||||
|
||||
## 诊断根本原因
|
||||
|
||||
### 运行 `/gsd-debug --diagnose`
|
||||
### 运行 `/msd-debug --diagnose`
|
||||
|
||||
如果执行产生了错误输出、存根代码或验证失败，使用诊断模式进行调查，而不应用任何修复：
|
||||
|
||||
```bash
|
||||
/gsd-debug --diagnose "Phase 2 executor produced stubs instead of real code"
|
||||
/msd-debug --diagnose "Phase 2 executor produced stubs instead of real code"
|
||||
```
|
||||
|
||||
`--diagnose` 在找到根本原因后停止，不修改您的文件。它会在 `.planning/debug/<slug>.md` 创建一个会话文件，以便您在需要时稍后继续调查。
|
||||
@@ -57,36 +57,36 @@ GSD 会在下次运行时检测到这一情况，并弹出一个安全恢复确
|
||||
要启动同时应用修复的完整调试会话：
|
||||
|
||||
```bash
|
||||
/gsd-debug "Login middleware not handling 401 correctly after phase 3"
|
||||
/msd-debug "Login middleware not handling 401 correctly after phase 3"
|
||||
```
|
||||
|
||||
GSD 收集症状，使用科学方法进行结构化调查，并提出修复方案。如果您的配置中设置了 `tdd_mode: true`，则在应用任何修复之前需要先有一个失败的测试。
|
||||
MSD 收集症状，使用科学方法进行结构化调查，并提出修复方案。如果您的配置中设置了 `tdd_mode: true`，则在应用任何修复之前需要先有一个失败的测试。
|
||||
|
||||
### 查看活动调试会话
|
||||
|
||||
```bash
|
||||
/gsd-debug list
|
||||
/msd-debug list
|
||||
```
|
||||
|
||||
显示所有打开的会话及其当前假设和下一步操作。要恢复特定会话：
|
||||
|
||||
```bash
|
||||
/gsd-debug continue <slug>
|
||||
/msd-debug continue <slug>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 使用 `/gsd-forensics` 进行事后分析
|
||||
## 使用 `/msd-forensics` 进行事后分析
|
||||
|
||||
如果根本原因从错误输出中无法判断——例如，计划引用了不存在的文件、执行产生了意外结果，或状态似乎已损坏——请运行取证调查：
|
||||
|
||||
```bash
|
||||
/gsd-forensics "Phase 3 execution stalled after wave 1"
|
||||
/msd-forensics "Phase 3 execution stalled after wave 1"
|
||||
```
|
||||
|
||||
GSD 分析 git 历史记录、`.planning/` 制品完整性、STATE.md 一致性、未提交的工作和孤立的 worktree。它将结构化报告写入 `.planning/forensics/report-<timestamp>.md`，并给出推荐的修复步骤。
|
||||
MSD 分析 git 历史记录、`.planning/` 制品完整性、STATE.md 一致性、未提交的工作和孤立的 worktree。它将结构化报告写入 `.planning/forensics/report-<timestamp>.md`，并给出推荐的修复步骤。
|
||||
|
||||
`/gsd-forensics` 是只读的——它不会修改您的项目文件。
|
||||
`/msd-forensics` 是只读的——它不会修改您的项目文件。
|
||||
|
||||
**可检测的问题：**
|
||||
|
||||
@@ -103,46 +103,46 @@ GSD 分析 git 历史记录、`.planning/` 制品完整性、STATE.md 一致性
|
||||
一旦底层问题解决，重新运行执行命令：
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1
|
||||
/msd-execute-phase 1
|
||||
```
|
||||
|
||||
GSD 会跳过 `SUMMARY.md` 已存在的计划，仅为剩余计划分派执行器。
|
||||
MSD 会跳过 `SUMMARY.md` 已存在的计划，仅为剩余计划分派执行器。
|
||||
|
||||
如果您只需要重新执行特定的 wave：
|
||||
|
||||
```bash
|
||||
/gsd-execute-phase 1 --wave 2
|
||||
/msd-execute-phase 1 --wave 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 使用 `/gsd-undo` 回滚
|
||||
## 使用 `/msd-undo` 回滚
|
||||
|
||||
如果执行产生了您想完全丢弃的代码，请使用计划清单进行回滚，而不是手动 `git revert`：
|
||||
|
||||
### 回滚单个计划
|
||||
|
||||
```bash
|
||||
/gsd-undo --plan 03-02
|
||||
/msd-undo --plan 03-02
|
||||
```
|
||||
|
||||
回滚阶段 `3` 中计划 `02` 的所有提交。GSD 在写入任何更改之前会显示确认界面。
|
||||
回滚阶段 `3` 中计划 `02` 的所有提交。MSD 在写入任何更改之前会显示确认界面。
|
||||
|
||||
### 回滚整个阶段
|
||||
|
||||
```bash
|
||||
/gsd-undo --phase 03
|
||||
/msd-undo --phase 03
|
||||
```
|
||||
|
||||
回滚阶段 `3` 的所有提交。GSD 会检查后续阶段是否依赖该阶段，并在继续之前发出警告。
|
||||
回滚阶段 `3` 的所有提交。MSD 会检查后续阶段是否依赖该阶段，并在继续之前发出警告。
|
||||
|
||||
### 从最近的提交中交互式选择
|
||||
|
||||
```bash
|
||||
/gsd-undo --last 5
|
||||
/msd-undo --last 5
|
||||
```
|
||||
|
||||
显示最近五个 GSD 提交，让您选择要回滚的内容。
|
||||
显示最近五个 MSD 提交，让您选择要回滚的内容。
|
||||
|
||||
---
|
||||
|
||||
@@ -151,7 +151,7 @@ GSD 会跳过 `SUMMARY.md` 已存在的计划，仅为剩余计划分派执行
|
||||
如果您在上下文重置或新会话后返回项目：
|
||||
|
||||
```bash
|
||||
/gsd-resume-work
|
||||
/msd-resume-work
|
||||
```
|
||||
|
||||
从上次交接中恢复您的完整会话上下文，包括当前阶段、阻塞项以及执行停止的位置。
|
||||
@@ -159,7 +159,7 @@ GSD 会跳过 `SUMMARY.md` 已存在的计划，仅为剩余计划分派执行
|
||||
或者，要查看当前进度并自动跳转到下一个正确步骤：
|
||||
|
||||
```bash
|
||||
/gsd-progress --next
|
||||
/msd-progress --next
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user