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:
@@ -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 引入棕地仓库
|
||||
|
||||
Reference in New Issue
Block a user