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
2026-10-06 01:47:40 +02:00
parent fe069b2a56
commit a9a7a328e6
2763 changed files with 78465 additions and 78434 deletions

View File

@@ -1,6 +1,6 @@
# 你的第一个项目
在本教程中,你将安装 GSD Core 并从头构建一个小型命令行待办事项应用——一个阶段、一个 PR、完整的流程循环。完成后,你将至少运行过核心阶段循环中的每一条命令一次,并看到每条命令所生成的规划产物。
在本教程中,你将安装 MSD Core 并从头构建一个小型命令行待办事项应用——一个阶段、一个 PR、完整的流程循环。完成后,你将至少运行过核心阶段循环中的每一条命令一次,并看到每条命令所生成的规划产物。
---
@@ -16,16 +16,16 @@
- **Claude Code** — 在你想使用的项目目录中打开。
- 初次安装需要网络连接。
不需要其他工具。GSD Core 本身将在下一步安装。
不需要其他工具。MSD Core 本身将在下一步安装。
---
## 第 1 步 — 安装 GSD Core
## 第 1 步 — 安装 MSD Core
在项目目录中打开终端并运行:
```bash
npx @opengsd/gsd-core@latest
npx @golem15/msd-core@latest
```
安装程序会询问你使用的 AI 编程运行时,以及是全局安装还是安装到当前项目。现在选择 **Claude Code** 和**本地安装**(仅此项目)。
@@ -35,10 +35,10 @@ npx @opengsd/gsd-core@latest
```text
✓ Installed 86 skills to .claude/commands/
✓ Installed agents to .claude/agents/
✓ GSD Core ready — run /gsd-new-project to start
✓ MSD Core ready — run /msd-new-project to start
```
注意项目中现在存在一个 `.claude/` 目录。这是 GSD Core 的命令和代理所在的位置。
注意项目中现在存在一个 `.claude/` 目录。这是 MSD Core 的命令和代理所在的位置。
> 为什么选本地而不是全局?本地安装可将技能版本固定到该项目。如需全局安装,请参阅 [在你的运行时上安装](../how-to/install-on-your-runtime.md)。
@@ -46,7 +46,7 @@ npx @opengsd/gsd-core@latest
## 第 2 步 — 以权限模式启动 Claude Code
GSD Core 会生成读写文件的子代理。以权限标志启动 Claude Code,这样它就不会在每次文件操作时暂停询问:
MSD Core 会生成读写文件的子代理。以权限标志启动 Claude Code,这样它就不会在每次文件操作时暂停询问:
```bash
claude --dangerously-skip-permissions
@@ -61,10 +61,10 @@ claude --dangerously-skip-permissions
在 Claude Code 提示符处输入以下斜杠命令:
```text
/gsd-new-project
/msd-new-project
```
GSD Core 将开启一段对话。它首先提问:
MSD Core 将开启一段对话。它首先提问:
```text
What do you want to build?
@@ -78,13 +78,13 @@ A Node.js CLI tool for managing to-do items. Users run `todo add "buy milk"`,
No external dependencies — Node built-ins only.
```
GSD Core 会继续提出几个澄清性问题。自然地回答即可。它在撰写任何计划之前,正在了解你的关注点。
MSD Core 会继续提出几个澄清性问题。自然地回答即可。它在撰写任何计划之前,正在了解你的关注点。
问题结束后,它会提议进行领域调研。对于如此小的项目,你可以跳过调研——在提示时选择**跳过调研**。
GSD Core 随后会要求你选择工作流设置(模式、粒度、调研代理)。每项均选择推荐的默认值。这些设置将写入 `.planning/config.json`。
MSD Core 随后会要求你选择工作流设置(模式、粒度、调研代理)。每项均选择推荐的默认值。这些设置将写入 `.planning/config.json`。
最后,一个路线图子代理开始运行(你会看到"Spawning roadmapper…"的提示——这是正常的,大约需要一分钟)。返回后,GSD Core 会展示一份路线图提案。对于单阶段项目,它看起来类似:
最后,一个路线图子代理开始运行(你会看到"Spawning roadmapper…"的提示——这是正常的,大约需要一分钟)。返回后,MSD Core 会展示一份路线图提案。对于单阶段项目,它看起来类似:
```text
Proposed Roadmap
@@ -115,7 +115,7 @@ Proposed Roadmap
## 第 4 步 — 清除上下文并讨论第 1 阶段
GSD Core 的设计围绕全新的上下文。在每个阶段之前清除主会话窗口:
MSD Core 的设计围绕全新的上下文。在每个阶段之前清除主会话窗口:
```text
/clear
@@ -124,10 +124,10 @@ GSD Core 的设计围绕全新的上下文。在每个阶段之前清除主会
然后开始第 1 阶段的讨论:
```text
/gsd-discuss-phase 1
/msd-discuss-phase 1
```
GSD Core 读取阶段目标并询问你的实现偏好。这些决定将影响*如何*构建,而不仅仅是*构建什么*。示例交流:
MSD Core 读取阶段目标并询问你的实现偏好。这些决定将影响*如何*构建,而不仅仅是*构建什么*。示例交流:
```text
> How should done items be stored — mark them in place or move them?
@@ -140,7 +140,7 @@ GSD Core 读取阶段目标并询问你的实现偏好。这些决定将影响*
Create it silently on first add.
```
讨论结束后,GSD Core 会写入:
讨论结束后,MSD Core 会写入:
```text
.planning/phases/01-core-cli/CONTEXT.md
@@ -153,7 +153,7 @@ GSD Core 读取阶段目标并询问你的实现偏好。这些决定将影响*
## 第 5 步 — 规划第 1 阶段
```text
/gsd-plan-phase 1
/msd-plan-phase 1
```
四个调研子代理并行展开工作(你会看到"Spawning 4 researchers…"的提示)。这需要 1–5 分钟,请勿中断。
@@ -169,17 +169,17 @@ GSD Core 读取阶段目标并询问你的实现偏好。这些决定将影响*
01-02-PLAN.md ← 任务:实现 add / list / done 命令
```
打开 `01-01-PLAN.md`。你会看到一个 `<task>` 块,包含名称、涉及的文件、操作步骤、验证命令和完成条件。注意 `<verify>` 标签——GSD Core 的执行器将在写入代码后运行该命令。
打开 `01-01-PLAN.md`。你会看到一个 `<task>` 块,包含名称、涉及的文件、操作步骤、验证命令和完成条件。注意 `<verify>` 标签——MSD Core 的执行器将在写入代码后运行该命令。
---
## 第 6 步 — 执行第 1 阶段
```text
/gsd-execute-phase 1
/msd-execute-phase 1
```
GSD Core 将计划分组为波次(独立计划并行运行),为每个计划生成一个全新的 200k 上下文执行器,并原子性地提交每个任务。
MSD Core 将计划分组为波次(独立计划并行运行),为每个计划生成一个全新的 200k 上下文执行器,并原子性地提交每个任务。
你将看到类似如下内容:
@@ -215,17 +215,17 @@ node todo.js done 1
node todo.js list
```
你应该看到条目出现,并且在标记完成后,条目 1 从默认列表中消失。这是 GSD Core 交付的你的第一个可见结果。
你应该看到条目出现,并且在标记完成后,条目 1 从默认列表中消失。这是 MSD Core 交付的你的第一个可见结果。
---
## 第 7 步 — 验证工作
```text
/gsd-verify-work 1
/msd-verify-work 1
```
GSD Core 提取阶段的成功标准并逐一引导你完成:
MSD Core 提取阶段的成功标准并逐一引导你完成:
```text
[1/3] Can you run `node todo.js add "buy milk"` without errors?
@@ -240,7 +240,7 @@ GSD Core 提取阶段的成功标准并逐一引导你完成:
All 3 checks passed. Phase 1 verified.
```
如果任何检查失败,GSD Core 会诊断根本原因并创建修复计划。再次运行 `/gsd-execute-phase 1` 应用修复,然后重新运行 `/gsd-verify-work 1`。
如果任何检查失败,MSD Core 会诊断根本原因并创建修复计划。再次运行 `/msd-execute-phase 1` 应用修复,然后重新运行 `/msd-verify-work 1`。
**创建的内容:**
@@ -253,10 +253,10 @@ All 3 checks passed. Phase 1 verified.
## 第 8 步 — 发布
```text
/gsd-ship 1
/msd-ship 1
```
GSD Core 使用自动生成的正文创建拉取请求。PR 正文始终包含:摘要、变更内容、已解决的需求、验证情况和关键决策。
MSD Core 使用自动生成的正文创建拉取请求。PR 正文始终包含:摘要、变更内容、已解决的需求、验证情况和关键决策。
你将看到:
@@ -272,15 +272,15 @@ Title: feat(phase-1): core CLI — add / list / done commands
## 你学到了什么
- 如何使用 `npx @opengsd/gsd-core@latest` 安装 GSD Core。
- `/gsd-new-project` 如何将一段对话转化为由 `.planning/` 产物支撑的路线图。
- `/gsd-discuss-phase` 如何在任何规划开始之前捕获实现决策。
- `/gsd-plan-phase` 如何生成并行调研器并产出原子任务计划。
- `/gsd-execute-phase` 如何以并行波次运行这些计划并提交每个任务。
- `/gsd-verify-work` 如何引导完成成功标准并在需要时生成修复计划。
- `/gsd-ship` 如何将已验证的阶段转化为拉取请求。
- 如何使用 `npx @golem15/msd-core@latest` 安装 MSD Core。
- `/msd-new-project` 如何将一段对话转化为由 `.planning/` 产物支撑的路线图。
- `/msd-discuss-phase` 如何在任何规划开始之前捕获实现决策。
- `/msd-plan-phase` 如何生成并行调研器并产出原子任务计划。
- `/msd-execute-phase` 如何以并行波次运行这些计划并提交每个任务。
- `/msd-verify-work` 如何引导完成成功标准并在需要时生成修复计划。
- `/msd-ship` 如何将已验证的阶段转化为拉取请求。
对于多阶段项目,对每个阶段重复第 4–8 步,然后运行 `/gsd-progress --next`,让 GSD Core 自动检测下一步。
对于多阶段项目,对每个阶段重复第 4–8 步,然后运行 `/msd-progress --next`,让 MSD Core 自动检测下一步。
---
@@ -288,4 +288,4 @@ Title: feat(phase-1): core CLI — add / list / done commands
- [阶段循环](../explanation/the-phase-loop.md) — 循环为何如此设计
- [操作指南](../README.md#how-to-guides) — 针对特定情况的任务型操作说明
- [接入现有代码库](onboarding-an-existing-codebase.md) — 将 GSD Core 引入棕地仓库
- [接入现有代码库](onboarding-an-existing-codebase.md) — 将 MSD Core 引入棕地仓库