Install
$ npx skills add aduhappy/multi-agent-project-skillREADME
# GitHub Repository: aduhappy/multi-agent-project-skill
**URL:** https://github.com/aduhappy/multi-agent-project-skill
**Author:** aduhappy
**Description:** Cross-agent, cross-tool resumable project skeleton (AGENTS.md + thin pointers + self-contained task cards + data provenance). Core principle: trust-but-verify — independent review gate ensures critical outputs are spot-checked before handoff. Pure Markdown, agents.md open standard. ⚡独立复核阀门 / 坏产物退役隔离 / 关键数字防漂移 / 委派模板已知坑+自查清单
**Homepage:**
**Language:**
## Stats
- Stars: 0
- Forks: 0
- Open Issues: 0
- Commits: 11
- Created: 2026-06-16T00:32:34Z
- Updated: 2026-06-18T13:30:47Z
- Pushed: 2026-06-18T13:29:14Z
## README
# Multi-Agent Project Skill
> 跨 agent、跨软件可续接的项目文档骨架生成器。一个权威入口 + 薄指针 + 自包含任务卡 + 收工规矩，全用纯 Markdown——换 Claude / Cursor / Gemini / ZCode / Codex / Copilot 任何一个，agent 进来读同一份入口就能接上前任工作。
[](LICENSE-MIT)
[](LICENSE-CC-BY-SA-4.0)
[](https://agents.md/)
---
## 🚀 安装
### 方式一：让 agent 自主安装（推荐）
直接对任何 AI agent（Claude / Cursor / Gemini / ZCode / Codex / Copilot 等）说一句：
> **把 `aduhappy/multi-agent-project-skill` 装成 skill**
agent 会自己判断操作系统、把仓库 clone 到本工具的 skills 目录、装完提示你新开会话即可触发。**无需手动选平台、无需手动挑路径。**
目标 skills 目录（agent 会根据当前工具自行选对）：
| 工具 | 用户级路径 | 项目级路径 |
|---|---|---|
| ZCode / Codex CLI | `~/.agents/skills/multi-agent-project` | `<项目>/.agents/skills/multi-agent-project` |
| Claude Code | `~/.claude/skills/multi-agent-project` | `<项目>/.claude/skills/multi-agent-project` |
| Cursor | N/A | `.cursor/rules/`（现代）或 `.cursorrules`（legacy）|
### 方式二：手动 clone（备用）
仓库地址：`https://github.com/aduhappy/multi-agent-project-skill.git`
```bash
# 用户级（装一次，所有项目可用）
git clone https://github.com/aduhappy/multi-agent-project-skill.git ~/.agents/skills/multi-agent-project
# 项目级（仅某个项目）
git clone https://github.com/aduhappy/multi-agent-project-skill.git .agents/skills/multi-agent-project
```
> Windows 用户的 `~` 对应 `%USERPROFILE%`；若 skills 目录不存在，先 `mkdir` 再 clone。
---
## 这是什么
一个 [Agent Skill](https://agentskills.io/)：在项目根目录生成一套**软件无关的纯 Markdown 协同骨架**。
设计目标——**真相只有一份**：`AGENTS.md` 是唯一权威入口，其他工具的约定文件（`CLAUDE.md` / `GEMINI.md` / `.cursorrules` / `.github/copilot-instructions.md`）全是 3 行薄指针，指向 `AGENTS.md`。换任何 AI 工具，agent 都读同一份入口，不丢上下文、不互相覆盖。
四条核心原则：
1. **真相只有一份** — AGENTS.md 是唯一权威入口
2. **细节外链、入口要短** — 入口 1–2 屏，细则下沉
3. **纯 Markdown + 相对路径** — 换工具不破
4. **信任但验证** — agent 自检不够，关键产物须独立复核才放行
### 和同类 skill 的区别
| Skill | 定位 | 适用 |
|---|---|---|
| [netresearch/agent-rules-skill](https://github.com/netresearch/agent-rules-skill) | 自动生成 `AGENTS.md`（从 Makefile/package.json 提取命令） | 软件工程项目 |
| **本 skill（multi-agent-project）** | **多 agent 接力的协同骨架** + 任务卡 + 数据溯源 + handoff | **科研 / 数据密集 / 多数据集 / 长管线项目** |
本 skill 的差异化亮点：
- **路径约定**——大文件进工作盘、小产物回仓库（防云同步爆炸 / 多 agent 撞车）
- **数据集 `来源.txt`**——DOI/URL/日期/口径/单位，换人换 agent 都能溯源
- **自包含任务卡**——冷启动可执行，零上下文 agent 能直接动手
- **决策记录（ADR）+ 词汇表 + 进度日志**——防下个 agent 重新踩坑、重新质疑已定的事
- **收工规矩**——每个 agent 退出前更新现状 + 看板，保证接力不断
- **独立复核阀门**——"别信自检"，关键产物必须主控/第三 agent 抽验后才放行下一棒
- **关键数字防漂移**——同一数字只在一处写定，收工前做一致性核对
- **坏产物退役隔离**——错产物立即标注作废，静默复用比没产出更致命
- **委派模板含已知坑+自查清单**——引导 agent 在报完成前自拦截常见错误类型
## 何时触发
说任一句都会触发：
- "开新项目/新课题""怎么组织文档让 AI 协同""AGENTS.md 怎么写"
- "多个 agent 接力""换软件继续""上下文丢失"
- "帮我建个项目文档""怎么让多个 AI 工具协同"
## 兼容性
遵循 [agents.md](https://agents.md/) 开放标准（60k+ 开源项目在用），兼容：
| 工具 | 入口文件 | 支持 |
|---|---|---|
| Claude Code | `CLAUDE.md` → AGENTS.md | ✅ |
| Cursor | `.cursorrules` / `.cursor/rules/` | ✅（`.cursorrules` 为 legacy，推荐 `.cursor/rules/*.mdc`）|
| Gemini CLI | `GEMINI.md` → AGENTS.md | ✅ |
| GitHub Copilot | `.github/copilot-instructions.md` | ✅ |
| OpenAI Codex | `AGENTS.md` | ✅ |
| ZCode | `AGENTS.md` | ✅ |
| 任何文本工具 | `AGENTS.md`（纯 Markdown） | ✅ |
## 只要模板文件，不要 skill
不想装成 skill、只想要骨架文件？直接复制 `assets/` 目录下的文件到你的项目根：
- `assets/AGENTS.md` → 你的项目 `AGENTS.md`
- `assets/CLAUDE.md` → 你的项目 `CLAUDE.md`
- `assets/任务规划_模板.md` → 你的项目 `文档/任务规划_<主题>.md`
- `assets/来源.txt` → 各数据集目录
> ⚠️ **中文文件名注意**：模板里 `任务规划_模板.md`、`委派任务模板.md`、`来源.txt` 含中文名。在部分 CI/工具/编码下可能出现路径问题（URL 编码不一致等）。如果你的 toolchain 对此挑剔，重命名为 ASCII 文件名（如 `task_plan.md`、`delegation_template.md`、`source.txt`）并更新 AGENTS.md §6 的指针即可。内容不受影响。
## 生成的文件骨架
```
<项目根>/
├── AGENTS.md ← 唯一权威入口（七板块）
├── STATUS.md ← 当前 handoff 状态（收工落盘）
├── CLAUDE.md ← 薄指针 → "以 AGENTS.md 为准"
├── GEMINI.md ← 薄指针
├── .cursorrules ← 薄指针（Cursor）
├── .github/copilot-instructions.md ← 薄指针（Copilot）
├── 文档/
│ ├── 任务规划_<主题>.md ← 自包含任务卡
│ ├── 决策记录/ ← 关键技术决策（ADR）
│ └── 词汇表.md ← 项目术语
├── <数据集名>/
│ ├── 来源.txt ← DOI/URL/日期/口径
│ └── ...
├── scripts/ ← 代码归位（不散落根目录）
│ └── README.md ← 脚本索引：干嘛/输入/输出/作者
└── 进度日志.md ← 带日期戳的变更流水
```
## AGENTS.md 的板块（顺序即优先级）
模板编号 1–7，其中**路径约定单独编号为 §5.5**（太重要，不能和铁律混在一起）。共 8 个板块：
1. **一句话北极星**——项目到底干嘛、给谁、什么基调
2. **当前故事/方法**——最新方向 + 核心方法 + 最近换过什么
3. **现在在哪**——每次收工更新，1–5 条带日期戳（接力最关键的交接点）
4. **任务看板**——`[ ]`/`[x]` + 谁负责 + 依赖 + 已知风险
5. **铁律/约定**——违反会返工的：环境调用、绘图/数据规矩、命名、口径、收工规矩
5.5. **路径约定**——大文件去哪、小产物回哪（防云同步爆炸/多 agent 撞车，单独成节）
6. **深读指针**——细节去哪个文档
7. **环境/工具**——完整工具路径怎么调、env 锁
> 入口控制在 1–2 屏，每个 agent 都得读完；细节全部外链。完整说明见 [`references/advanced.md`](references/advanced.md)（8 个进阶板块：ADR、词汇表、进度日志、验收具体化、handoff 格式、命名约定、环境锁、数据快照）。
## 跨软件能续的七个硬要求
1. **纯 Markdown + 相对路径 + 标准文件名**——别用某软件专属语法
2. **数据带 `来源.txt`**（DOI/URL/日期/口径/单位）——换人换 agent 都能溯源
3. **收工规矩写进铁律**——每个 agent 退出前更新 §现在在哪 + §任务看板 + 写/更新 `STATUS.md`（handoff 落盘文件，下个 agent 读这个就能接上，不依赖对话历史）
4. **路径纪律**——"大文件进工作盘、小产物回仓库""复制不剪切"
5. **新 agent（含子 agent）进门第一件事**——读完 AGENTS.md（含 STATUS.md）再动手，不靠对话历史、不凭记忆乱猜
6. **关键数字单一来源**——同一数字只在一处写定，别处只引用不复述；收工核对一致性
7. **坏产物退役隔离**——错产物立即标 `_DEPRECATED` + AGENTS.md 红字通告 + 看板更新
> 新增的 6 和 7 来自实战教训：多 agent 各自改文档会导致数字漂移（同一值差 1%+），坏产物被下游静默复用比没产出更致命。
## 两层续接（缺一不可）
- **硬续接（主依赖）**：仓库里的 Markdown，软件无关，任何 agent/人都能读——这是真相源。
- **软续接（增强）**：记忆层（ChatMem / Cursor memory / Claude memory）加速检索，但别让核心结论只活在记忆里，必须落回 Markdown。
> 判据：把所有记忆层删光，下个 agent 只靠仓库 Markdown 也能接上 → 合格。
## 起源
这套骨架来自一个真实科研项目的多 agent 实战——多源数据集、长分析管线（拉数据 → 清洗 → 建模 → 重建）、云同步工作目录、Claude + Cursor + ZCode 多软件接力。踩过的坑（agent 覆盖彼此产出、找不到状态、云同步卡死、下个 agent 重新质疑已定方向）都固化成了铁律。
## 许可证
双许可证（跟 [netresearch/agent-rules-skill](https://github.com/netresearch/agent-rules-skill) 一致）：
- **代码 / 脚本**：[MIT](LICENSE-MIT)
- **文档 / 模板内容**：[CC BY-SA 4.0](LICENSE-CC-BY-SA-4.0)
本项目遵循 [agents.md](https://agents.md/) 开放标准。
## 参考
下列项目为本 skill 的设计提供了关键启发：
- [netresearch/agent-rules-skill](https://github.com/netresearch/agent-rules-skill) —— 双许可证结构、README 发布标配、薄指针（CLAUDE.md 9 字节）的做法
- [breezewish/CodexPotter](https://github.com/breezewish/CodexPotter) —— 跨轮次文件记忆（STATUS.md）、新 agent 进门仪式、任务委派话术的灵感
Information
Repository
Language
Unknown
Created
2026/6/18
Updated
2026/6/19