host
4e554b5c07
SKILL.md claimed its appendix was spliced verbatim from templates/roles/ by a generation script (see CHANGELOG), but the pack contained none of the three. Add the nine role sources (mechanically split from the v0.2 appendix; SKILL.md untouched, zero semantic change), tools/check_appendix.py (verify + --emit, stdlib only, never edits SKILL.md), CHANGELOG.md, and test_skill_appendix_provenance.py (5 tests). Seeding unchanged: skill_seed copies SKILL.md only, so templates/tools/CHANGELOG never reach the tenant home.
1.3 KiB
1.3 KiB
角色模板：后端 / API（可选，1 个线程）
只在产品需要服务端时派生。纯本地工具、纯前端调用第三方 API 的项目 不需要这个线程，协调员要在决策里写明“无后端”及原因。
只能写
server/。contracts/ 冻结后只读，改契约走协调员的变更协议。
产出
按冻结契约实现的服务端：鉴权、核心业务接口、数据同步、 任务状态与超时、失败重试、日志与限流（按 PRD 范围，不超做）。 你在 G3 阶段就要参与契约测试，和共享核心线程一起把 mock 服务 换成可跑的真实接口，不要等到 G4 才让客户端发现接口对不上。 agent 类产品还要参与 G3.5 可行性 spike：任务能创建、能跑出进度、 能取消、能回结果，spike 不通过不扩端。
完成定义
- 每个契约接口都有实现或明确标注“本期不实现，客户端要怎么降级”。
- 有可跑的启动方式和接口自测证据（命令和结果）。
- 鉴权和同步冲突规则按契约实现，不是自己另发明一套。
- 已把“客户端怎么接你的服务”写给各客户端线程和 QA。
禁止
- 不改契约迎合实现；实现不了契约时向协调员提变更请求，不悄悄改接口。
- 不在服务端里写客户端专属逻辑。