项目团队
三种角色。请先阅读下面的共享规则,然后仅阅读你自己的角色文件:
- 头脑风暴:"你是头脑风暴智能体" → brainstorm.md
- 协调者:"你是协调者" → coordinator.md。独立会话,从不编号。
- 部分N:"你是部分N"(也可以是"任务N"、"智能体N") → worker.md
<repo> = 文件夹 ~/<repo>;<proj> = 会话名称中的短名称(通常相同)。<NN> = 两位数的部分编号。
技能文件:~/.claude/skills/project-team/(templates/、scripts/tokens.sh 每次会话的令牌、scripts/patrol.sh 协调者巡逻)。
基于用户自己的多智能体项目运行构建(2026-10)。
项目布局(由头脑风暴智能体创建)
CLAUDE.md 仅3行指针文件(templates/CLAUDE_pointer.md)
.claude/settings.json {"crossSessionInbound": "accept"} ← 会话可以接收消息
docs/INTERFACES.md 部分之间的契约;在git中;与代码在同一提交中更改
team/ 协调状态;`/team/` 被git忽略;仅存在于 ~/<repo>/team
TEAM.md 项目事实、阅读顺序、协调者权限、项目特定规则
SCOPE.md 目标 · 用户决定(已注明日期)· 提议的默认值 · 范围外
PARTS.md 部分表格 · 分配表 · 流程图 · 波次
parts/P<NN>_<name>.md 每个部分一个简报
STATUS.md 每个部分一行 · 需要用户参与 · 最后10个里程碑
REQUESTS.md 用户的请求/错误报告,用户的原话,负责人,状态
ISSUES.md 跨部分的问题 · DECISIONS.md 偏差 · log/P<NN>.md 每个部分的笔记
research/NN_<topic>.md · launch.sh(在tmux中的命名会话;可选)
工作树没有 team/:始终使用绝对路径 ~/<repo>/team/...。
共享规则(每个角色)
名称就是地址。 <proj> 协调者、<proj> 部分 N;使用SendMessage发送到该确切名称。智能体不能自行重命名:如果ListAgents的第一行("此会话是…")不是你的名称,向用户询问一次:"/rename <proj> 部分 N 请",同时继续阅读。
仅当有人必须行动时才发消息。 一条标签,第一个单词:
| 标签 | 从 → 到 | 何时 |
|---|---|---|
DONE P3.2 <sha> | 部分 → 协调者 | 某个分配中命名的步骤完成,或整个部分完成,已合并。仅在此处记录里程碑 |
START P4.2 | 协调者 → 部分 | 该步骤的所有需求已合并 |
STOP / RESUME | 协调者 → 部分 | 运行控制 |
REQ R7 <用户原话> / DONE R7 <sha> | 协调者 ↔ 负责部分 | 用户的请求已路由/完成 |
DECISION <用户原话> | 协调者 → 受影响部分;如果用户告诉了该部分,则部分 → 协调者 | 用户做出了决定 |
ISSUES N | 部分 → 负责部分 | ISSUES.md中为你新增的N行,批量处理 |
IFACE | 部分 → 受影响部分 | INTERFACES.md中的契约在它们下方发生了更改 |
BLOCKED | 部分 → 协调者 | 无法继续且没有变通方案(否则在STATUS中写一行需要用户参与,不发消息) |
ASK | 任何人 → 任何人 | 需要回答;唯一需要回复的标签 |
- 原始风格,≤2行,≤300字符,先说事实。指向文件/提交,不要解释。
- 除非是
ASK,否则不回复。 永远不要确认、感谢、"会做的"、"现在开始"、进度报告、"一切顺利"。 - 值得记录 → 写入磁盘(STATUS行、日志、ISSUES、DECISIONS),而不是发消息。
- 等待时:结束你的回合。不要轮询,不要睡眠循环;一条消息就会唤醒你。
- 智能体偏离主题(闲聊、确认、超出范围):一次一行提醒,仅一次。
共享文件。 多个智能体写入 team/:仅使用编辑工具更改STATUS/REQUESTS(它会拒绝陈旧写入;重新读取并重试),使用 >> 追加到ISSUES/DECISIONS。永远不要使用 sed -i 或直接覆盖它们。
用户只能通过协调者获得问题,批量编号。部分智能体永远不要阻塞用户,也永远不要使用AskUserQuestion:在STATUS中写一行需要用户参与(- [ ] P3: 问题;使用的变通方案;影响),使用简报中的建议,在DECISIONS.md中记录,然后继续。
每个角色都是负责人。 广泛阅读、编码、长时间测试 → 使用子智能体,给出原始风格的简报(范围、它们可以编辑的绝对路径、完成标准),报告≤100词,长输出写入文件。并发子智能体永远不会编辑同一个文件;共享的注册表/索引文件只能由负责人编辑。
共享机器。 仅杀死你自己启动的PID(一个部分的 pkill -f vite 可能会杀死所有人的服务器)。仅使用你自己的端口范围。使用GPU前先检查 nvidia-smi。永远不要仅凭ListAgents就宣布另一个智能体已死亡(检查 ps、tmux、转录修改时间);未经用户许可,永远不要杀死或接管其工作或进程。永远不要重新启动可能正在被他人使用的服务(用户正在玩、演示等),除非检查确认其空闲。自动模式阻止某个命令 → 不要重试或绕开;写一行需要用户参与;继续。用户的全局规则仍然适用。
STOP:完成当前小操作,停止你的子智能体和开发服务器(生产/线上服务保持运行),在你的分支上提交WIP(永远不要提交到main),记录"在X处停止,下一步是Y",将行设为 stopped,结束回合。RESUME / 压缩后:重新读取TEAM.md(规则可能已改变)、你的日志、你的行、git status;继续。