项目状态由 Superself 管理时，用 self…

当 `AGENTS.md`/`CLAUDE.md` 含 `superself` 块或 `self setup` 能解析到已注册项目时，用 `self` CLI 读写项目状态，让下一会话接续上一会话。

适用场景

解决思路

1. 安装/使用 Superself CLI：`npm install -g superself@0.6.1`（Node 22.12+）；它把项目的 goals、decisions、work units、reports 作为 append-only event log 版本控制在独立于代码的 git 仓库中，状态按需派生、无需手工维护。
2. 确认适用：检查项目的 `AGENTS.md` 或 `CLAUDE.md` 是否包含 `<!-- superself:begin` 到 `<!-- superself:end -->` 的块，或运行 `self setup` 看它输出的 workspace、project、store 是否解析到当前目录。
3. 在依赖具体 verb 或 flag 前，先检查版本兼容性：本技能针对 `superself@0.6.1`；若 major 或 minor 不同，运行 `self <command> --help` 确认后再使用。
4. 会话开始运行 `self context`，把输出当作当前真相：goal、active decisions and conventions、open work、recent reports；它是从日志折叠生成的，绝不手工写。
5. 如果 `self context` 缺少某些内容，那是故意被放在渲染集合之外；用 `self search <query>` 查找 context 未包含的 live records。
6. 用 `self work show <id>` 打印某一个工作单元的完整 brief 和 report history。
7. 实质性工作要挂接到 work unit：用 `self work add "<required outcome>"` 创建，outcome 是必须变成真的结果，而不是任务。
8. 创建后运行 `self work start <id>`：它会读取 brief 并记录本会话接手了该单元；若另一会话持有它，CLI 会说明是谁、从何时开始，且不会拒绝；自行判断并继续。
9. 提交后报告进度：运行 `self report <id> "<what happened>"`；当前 HEAD commit 会自动作为 evidence 附加。
10. 如需附加其他证据，用 `self report <id> "<what happened>" --evidence <commit|note>`；如需附加更长 brief，用 `self report <id> "<what happened>" --file <path>`。
11. 记录用户已确认的决策：运行 `self decide "<text>" --why "<reason>"`；用户尚未确认时加 `--proposed`；每个 event 只记一个 decision。
12. 被阻塞时运行 `self work block <id> --on decision|dependency|external --why "..."`。
13. 工作单元被取代或转移时运行 `self work retire <id> --why "..." [--successor <id>]`。
14. 永远不要把被阻塞、被取代或转移的单元标记为 done，也不要让它虚假地保持 blocked。
15. 发现目标与当前状态之间存在缺口时，用 `self work propose` 和对应 brief 提出工作，由用户 accept 或 decline。
16. 用户批准了下一步或继续事项时，立即用 `self work add` 及背后 context 注册；只存在于对话中的计划会在对话结束时丢失。
17. 关闭工作单元：仅当 report 带有 commit 或 artifact，或 done 本身说明可验证发生了什么时，才用 `self work done <id>` 关闭；也可用 `self work done <id> --report "<what verifiably happened>"`。
18. 裸声明会被拒绝；已声明的 criteria 会一直 gate，直到每一项都被覆盖。
19. 记录文本一旦确认就 immutable；通过重新陈述来纠正：在任何 add verb 上加 `--supersedes <id>` 记录新措辞并保留 lineage。
20. 用 `retract` 撤回一条记录，且没有替代记录。
21. 记录（events、decisions、reports、conventions）用英文写，方便下一个打开的人阅读；对用户用其自己的语言回答。
22. 分支通过 pull request 进入 main：PR review 和 CI 拥有 merge control；Superself 拥有 context 和 work graph，不拥有 merge gate。
23. 绝不手工编辑生成的状态文件或 `.superself/` 下的任何内容。
24. 在没有 superself block 的项目中，先运行 `self setup`。
25. 如果 `self setup` 将目录解析到已注册项目，问用户一次是否运行 `self connect`；该命令会把 managed block 写入 `AGENTS.md` 或 `CLAUDE.md`。
26. 如果 `self setup` 未解析到项目，问用户一次是否用 `self project init` 注册；绝不自行注册或连接项目。
27. 需要深入时运行 `self --help` 列出所有 verb；运行 `self <command> --help` 打印单个命令的 flags 且不触碰状态。
28. 阅读 CLI 自带 topic guides：`self help agents`（会话如何从头到尾驱动 CLI）、`self help context`（`self context` 渲染什么以及为何缺内容）、`self help records`（所有 record kind 背后的实体及如何纠正 record）、`self help placement`（scope、priority、exposure——record 如何进入 context）、`self help work`（work graph：outcomes、evidence、criteria、proposals）、`self help goals`（长期 goals、objectives、milestones 及达成所需）、`self help workspace`（store、其中的 projects、跨机器迁移）。

适用边界 · 注意事项

• 当 `self --version` 失败或项目不使用 Superself 时，不适用；不要手工编造状态。
• 使用与 `superself@0.6.1` 不同 major/minor 的版本时，未先查 `self <command> --help` 不要依赖特定 verb/flag。
• 不要在用户未确认时自行运行 `self connect` 或 `self project init` 来注册/连接项目。