Commit 238a8051 by DaiJiezhang

docs: clarify migration rollback and restore

parent 74111699
...@@ -29,7 +29,6 @@ grill-with-docs ...@@ -29,7 +29,6 @@ grill-with-docs
- `to-tickets`:把 Spec 拆成可独立验收的 Ticket,并声明阻塞关系。 - `to-tickets`:把 Spec 拆成可独立验收的 Ticket,并声明阻塞关系。
- `implement`:按 Spec 或 Ticket 开发、测试和提交。 - `implement`:按 Spec 或 Ticket 开发、测试和提交。
- `code-review`:开发完成后检查变更。 - `code-review`:开发完成后检查变更。
### Restore project skills ### Restore project skills
Skill files are generated directories and are intentionally ignored by Git. After a fresh clone or worktree, materialize the ten locked matt-pocock Skills for Codex and Claude Code: Skill files are generated directories and are intentionally ignored by Git. After a fresh clone or worktree, materialize the ten locked matt-pocock Skills for Codex and Claude Code:
...@@ -37,10 +36,9 @@ Skill files are generated directories and are intentionally ignored by Git. Afte ...@@ -37,10 +36,9 @@ Skill files are generated directories and are intentionally ignored by Git. Afte
```bash ```bash
npx --yes skills add mattpocock/skills --skill grill-with-docs --skill implement --skill setup-matt-pocock-skills --skill to-spec --skill to-tickets --skill code-review --skill domain-modeling --skill grilling --skill tdd --skill triage --agent codex --copy -y npx --yes skills add mattpocock/skills --skill grill-with-docs --skill implement --skill setup-matt-pocock-skills --skill to-spec --skill to-tickets --skill code-review --skill domain-modeling --skill grilling --skill tdd --skill triage --agent codex --copy -y
npx --yes skills add mattpocock/skills --skill grill-with-docs --skill implement --skill setup-matt-pocock-skills --skill to-spec --skill to-tickets --skill code-review --skill domain-modeling --skill grilling --skill tdd --skill triage --agent claude-code --copy -y npx --yes skills add mattpocock/skills --skill grill-with-docs --skill implement --skill setup-matt-pocock-skills --skill to-spec --skill to-tickets --skill code-review --skill domain-modeling --skill grilling --skill tdd --skill triage --agent claude-code --copy -y
git restore --source=HEAD -- skills-lock.json
``` ```
The first two commands materialize `.agents/skills/` and `.claude/skills/`. The final command keeps the repository's locked versions unchanged after the installer checks upstream metadata. Do not hand-edit `skills-lock.json`. 安装前确认 `skills-lock.json` 没有未提交修改。安装后检查 `git diff -- skills-lock.json`,只保留本次 matt-pocock Skill 的锁定记录;如果安装器改动了其他 Skill 的 hash,先确认没有本地锁文件修改,再手动恢复对应无关差异。不要无条件覆盖整个锁文件,也不要手工改写锁定内容。
### Issue tracker ### Issue tracker
......
...@@ -214,8 +214,9 @@ chore: archive openspec history ...@@ -214,8 +214,9 @@ chore: archive openspec history
1. 在迁移 worktree 运行 `npx --yes skills --help`,确认安装工具可用; 1. 在迁移 worktree 运行 `npx --yes skills --help`,确认安装工具可用;
2. 使用 `skills add``mattpocock/skills` 安装十个锁定 Skill,分别指定 `--agent codex``--agent claude-code` 2. 使用 `skills add``mattpocock/skills` 安装十个锁定 Skill,分别指定 `--agent codex``--agent claude-code`
3. 检查 `.agents/skills/``.claude/skills/``skills-lock.json` 的实际结果; 3. 检查 `.agents/skills/``.claude/skills/``skills-lock.json` 的实际结果;
4. 如果安装工具顺手重算了无关 Skill 的 hash,运行 `git restore --source=HEAD -- skills-lock.json` 保留仓库锁定版本; 4. 安装前若 `skills-lock.json` 已有未提交修改,先停止并保留它;安装后只接受十个 matt-pocock Skill 的锁定新增;
5. 安装失败不阻塞 OpenSpec 封存,在 `AGENTS.md` 记录恢复命令和用户级前提。 5. 安装器改动其他 Skill 的 hash 时,先确认没有本地锁文件修改,再手动恢复无关差异,不无条件覆盖整个锁文件;
6. 安装失败不阻塞 OpenSpec 封存,在 `AGENTS.md` 记录恢复命令和用户级前提。
Skill 安装失败不得阻塞阶段一的历史封存。 Skill 安装失败不得阻塞阶段一的历史封存。
...@@ -400,6 +401,17 @@ chore: configure matt-pocock workflow ...@@ -400,6 +401,17 @@ chore: configure matt-pocock workflow
- 由安装工具产生的 `skills-lock.json` 更新(如果安装机制确认可用) - 由安装工具产生的 `skills-lock.json` 更新(如果安装机制确认可用)
- `docs/plans/2026-09-16-openspec-to-matt-pocock-migration.md` - `docs/plans/2026-09-16-openspec-to-matt-pocock-migration.md`
### 6.6 后续评审修复提交
实施完成后,如果评审发现非业务范围的小问题,使用独立修复提交,不重写前面的历史提交:
```text
fix: complete matt-pocock workflow metadata
fix: finalize workflow documentation
```
因此本次最终提交由四个阶段性提交组成:封存历史、建立工作流、补齐元数据、修正文档。
--- ---
## 7. 旧任务处理规则 ## 7. 旧任务处理规则
...@@ -452,6 +464,7 @@ docs/plans/2026-09-16-openspec-to-matt-pocock-migration.md ...@@ -452,6 +464,7 @@ docs/plans/2026-09-16-openspec-to-matt-pocock-migration.md
```text ```text
.gitignore .gitignore
README.md(默认后端说明)
skills-lock.json(仅允许安装工具修改) skills-lock.json(仅允许安装工具修改)
``` ```
...@@ -493,7 +506,7 @@ lamprey worktree ...@@ -493,7 +506,7 @@ lamprey worktree
13. 没有迁移 99 条旧 task; 13. 没有迁移 99 条旧 task;
14. 没有同时保留可继续增长的两套工作流; 14. 没有同时保留可继续增长的两套工作流;
15. 没有业务逻辑变化; 15. 没有业务逻辑变化;
16. 计划书本身已包含在第二个提交中 16. 计划书本身已提交;实施可包含后续评审修复提交
17. 没有触碰 `lamprey` 的 pnpm 草稿。 17. 没有触碰 `lamprey` 的 pnpm 草稿。
--- ---
...@@ -536,7 +549,7 @@ git diff --name-only -- backend-nest frontend ...@@ -536,7 +549,7 @@ git diff --name-only -- backend-nest frontend
| Skill 只在当前电脑可用 | 确认安装机制并由工具更新 lockfile | | Skill 只在当前电脑可用 | 确认安装机制并由工具更新 lockfile |
| 修改影响业务 | 不改业务逻辑,只改文档、配置和注释 | | 修改影响业务 | 不改业务逻辑,只改文档、配置和注释 |
| 本地任务不适合团队 | 后续可切换 GitLab Issues,不影响历史封存 | | 本地任务不适合团队 | 后续可切换 GitLab Issues,不影响历史封存 |
| 新流程不适合 | 两个独立提交,可以分别回滚 | | 新流程不适合 | 四个阶段性提交,可以分别回滚 |
--- ---
...@@ -545,7 +558,7 @@ git diff --name-only -- backend-nest frontend ...@@ -545,7 +558,7 @@ git diff --name-only -- backend-nest frontend
如果只撤销 matt-pocock 工作流: 如果只撤销 matt-pocock 工作流:
```text ```text
回滚 Commit 2 回滚 Commit 2,以及后续评审修复提交
``` ```
如果连 OpenSpec 封存也撤销: 如果连 OpenSpec 封存也撤销:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment