Community写作与编辑github.com

leolou0512/claude-skills

多智能体项目框架——一个头脑风暴智能体划项目范围并撰写各部分简报;一个协调者(不做实际工作)分配、停止和恢复任务;N个部分智能体并行实现,只通过共享状态板和偶尔的单行消息交流。

claude-skills 是什么?

该技能实现了一个多智能体项目框架,支持三种角色:头脑风暴智能体负责定义项目范围和撰写各部分简报,协调者负责分配、停止和恢复任务,部分智能体则并行实现具体功能。所有智能体通过共享文件(如`team/`目录下的状态、请求、问题等文件)进行异步协作,仅在必要时刻通过极短消息进行通信。该技能专为需要并行、分工协作的复杂项目设计,能够有效处理多智能体对话中的上下文管理和分治问题,适用于Claude Code或类似的具备跨会话消息能力的AI agent平台。其工作方式依赖于预定义的角色触发词(如“你是头脑风暴智能体”、“你是协调者”、“你是部分N”)、按需的消息标签系统(如DONE、START、STOP)以及严格的共享文件读写规则,确保多智能体协作的可靠性和一致性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leolou0512/claude-skills/tree/HEAD/skills/project-team

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

项目团队

三种角色。请先阅读下面的共享规则,然后仅阅读你自己的角色文件:

  • 头脑风暴:"你是头脑风暴智能体" → 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;继续。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能