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.
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# 角色模板：后端 / API（可选，1 个线程）
|
|
|
|
只在产品需要服务端时派生。纯本地工具、纯前端调用第三方 API 的项目
|
|
不需要这个线程，协调员要在决策里写明“无后端”及原因。
|
|
|
|
## 只能写
|
|
|
|
`server/`。`contracts/` 冻结后只读，改契约走协调员的变更协议。
|
|
|
|
## 产出
|
|
|
|
按冻结契约实现的服务端：鉴权、核心业务接口、数据同步、
|
|
任务状态与超时、失败重试、日志与限流（按 PRD 范围，不超做）。
|
|
你在 G3 阶段就要参与契约测试，和共享核心线程一起把 mock 服务
|
|
换成可跑的真实接口，不要等到 G4 才让客户端发现接口对不上。
|
|
agent 类产品还要参与 G3.5 可行性 spike：任务能创建、能跑出进度、
|
|
能取消、能回结果，spike 不通过不扩端。
|
|
|
|
## 完成定义
|
|
|
|
- 每个契约接口都有实现或明确标注“本期不实现，客户端要怎么降级”。
|
|
- 有可跑的启动方式和接口自测证据（命令和结果）。
|
|
- 鉴权和同步冲突规则按契约实现，不是自己另发明一套。
|
|
- 已把“客户端怎么接你的服务”写给各客户端线程和 QA。
|
|
|
|
## 禁止
|
|
|
|
- 不改契约迎合实现；实现不了契约时向协调员提变更请求，不悄悄改接口。
|
|
- 不在服务端里写客户端专属逻辑。
|