towow-dev-handofflisted
Install: claude install-skill floccose-burner9185/wow-harness
# Towow 开发接手入口
## 目标
这个 skill 不负责复述 Towow 的全部历史,也不负责重新总结理念。
它只负责一件事:**让新接手 Towow 开发的 AI,在一次入场中找到最新、可执行、可验证的上下文入口。**
默认场景:
- 接手 Towow 生产开发
- 梳理当前主线
- 开始生产排障
- 继续上一轮工作
- 进入 MCP / protocol / matching / run 链路的真实代码
## 启动协议
每次新 AI 接手 Towow 时,按这个顺序执行:
1. 先运行:
```bash
python3 .claude/skills/towow-dev-handoff/scripts/collect_handoff_context.py
```
2. 先读 repo 真相源,再读派生资料。
- 如果任务涉及公网入口、部署、demo、MCP 默认地址、中国直连,先补读:
- `docs/architecture/NETWORK-TOPOLOGY.md`
- `ops/nginx/*.conf`
- `scripts/deploy.sh`
- `scripts/deploy-demo.sh`
- `scripts/deploy-edge.sh`
3. 根据脚本输出,补读最近的 issue / decision / review。
4. 再读 Cloud memory 中最新的项目记忆。
5. 再抽查最近 1-3 个 transcript,只看有效用户意图,不看命令噪声。
6. 最后形成当前接手摘要。
## Truth Policy
我不是新的权威副本。我只负责把新 agent 引到当前仍然活着的真相源上。
## 真相源优先级
遇到信息冲突时,按这个优先级判断:
1. `CLAUDE.md`
2. `MEMORY.md`
3. `docs/INDEX.md`
4. 最近的 `docs/issues/*.md`、`docs/decisions/*.md`、`docs/reviews/**/*.md`
5. Cloud 项目目录下的 `memory/`
6. transcript `.jsonl`
规则:
- 不要把 skill 自己当成新的权威副本。
- skill 负责导航,不负责复制现有知识。
- 如果发现 source drift,必须显式指出冲突点和你最终采用的来源。
## 治理机制入口(ADR-030)
Towow 有一套上下文工程系统(不是 prompt),通过 PostToolUse hook 在编辑文件时自动注入相关思维框架:
- **路由表**:`scripts/context_router.py` — 文件路径 → 上下文片段映射
- **片段库**:`scripts/context-fragments/` — 精炼的领域规则(每个 10-25 行)
- **Guard 路由**:`scripts/guard_router.py` — 文件路径 → guard 脚本映射
- **Hook 入口**:`scripts/guard-feedback.py` — PostToolUse 目标
- **设计文档**:`docs/decisions/ADR-030-guard-signal-protocol-and-governance-reload.md`
如果 PostToolUse hook 正常工作,