name: guide-meta-agent-system description: | v5 入口 — Lead + Sub-agent + Agent-Team-Member + Meta-meta + Skill-manager + Advisor 协作系统宪法(7 角色)。 v4 在 SKILL.md 单文件中累积过满(1638 行),v5 拆分为 13 个聚焦文件 + 1 入口索引, 提升 cold-start navigability,并新增 7 角色 (含 skill-manager + advisor) / mermaid 数据流图 / enforcement layer / dashboard 规范。 type: guide status: active version: v5 last_verified: 2026-04-09 supersedes: [guide-meta-agent-system v4]
guide-meta-agent-system v5 — 入口索引
本文件是导航。不读它就不知道去哪,只读它什么都不会做。 想做事 → 按下方阅读顺序跳到具体文件。
北极星 (one sentence)
Lead Claude 在单 session 上下文有限的前提下,通过元思考链 + 7 角色协作 + 强制 ritual,持续推进策略迭代和基础设施迭代,向自动化盈利系统收敛。
核心概念(统一模型)
整个系统由 三实体 × 三关系 描述(详见 14-consolidation-workflow §14.2.5):
- 三实体: Meta(原子思考单元)/ Chain(时间 DAG, parent/supersedes)/ Tower(抽象蒸馏层级, L0→L3)
- 两个正交维度: Chain 是水平时间轴("怎么走到这里"),Tower 是垂直抽象轴("意味着什么")。同一 meta 同时存在于两者。
- Meta × Task: Meta 是 WHAT/WHY 的容器,下挂 task list(探索 / 验证 / 执行),sub-agent 执行 task,output 回流到 Meta Execution;之后可"扩大"(chain 上 phase2)或"蒸馏"(tower 上一层)。
- Tower 四层: L0 raw (
76) → L1 topic (12) → L2 principle (~4) → L3 wisdom (1-2)。 - Tower 的价值: 执行中易陷入局部细节;蒸馏是从执行细节抽离、向高维抽象,让 Lead 发现系统性问题、跳出困境去做更容易更正确的事。
不要忘: 后续所有 ritual / CLI / agent spec 都是这些原语的具体实例化。
三种 team-member archetype(advisor / executor / evaluator)的完整 spec + 跨域复用见 15-team-member-patterns。
v5 vs v4 changelog
| 维度 | v4 | v5 |
|---|---|---|
| 文件结构 | SKILL.md 单文件 1638 行 | 13 拆分文件 + 入口索引 |
| 角色数 | 4 (User / Lead / Sub-agent / Meta-meta) | 6 (+Agent-Team-Member, +Skill-manager);v5.2 +advisor 共 7 |
| 数据流图 | 0 mermaid | 7 mermaid (4 dataflow + 3 lifecycle) |
| Skill-manager | 不存在 | 完整 spec (10) |
| Dashboard | 散落 Part 7/14 | 集中到 06 |
| Sub-agent vs Agent Team | 概念混用 | 显式区分 (01 §对比表) |
| Spawn prompt 可见性 | 不可见 | 提案 meta-cli prompt <id> (06) |
| Cold-start 自评 | 8.5/10 | 目标 9/10 (拆分后单文件 < 600 行更易消化) |
v5 触发原因: User 反馈 v4 单文件难导航 + cs2-v4 session 暴露 skill 漂移 + 缺少 post-commit skill 维护 agent。完整动机见 00-设计出发点。
v5.x minor updates
| 版本 | 日期 | 主要改动 |
|---|---|---|
| v5.1 | 2026-04-11 | unified meta (task+finding 合一) + meta-coder 命名空间 (ADR-001) |
| v5.2 | 2026-04-15 | advisor 第 7 角色 + tower distillation 工作流 (v5/14 §14.2.5 统一模型) |
| v5.3 | 2026-04-15 | chain=workflow 定义 / Dim 9 / reversed decision tree / lessons/ promote / team-member-patterns (v5/15) |
14 文件清单 + ADR/Examples
v5.1 升级 (2026-04-11): ADR-001 已激活 — task+finding 合一为 unified
meta-*.md, data layer 从task-*/meta-thinking/7-ops/迁移到.claude/meta-coder/meta-chains/<chain>/。 新 cold-start canonical 路径见下方"阅读顺序建议"表的Cold-start 新 Lead行。
| # | 文件 | 一句话 |
|---|---|---|
| 00 | 设计出发点 | 为什么这套系统存在;7 约束推导;v2→v5 演化 |
| 01 | 角色与边界 | 7 角色定义 (含 advisor)、对比表、operational play |
| 02 | 元思考链 | 4 重身份、6 type、status 流转 + completed status (v5.3 补丁)、consolidation |
| 03 | 标准ritual | Step 0 + Step 1-10 + Step 11,三层 lifecycle |
| 04 | 辩证ritual | 4 rounds + Round 5 Pivot |
| 05 | 数据流图 | 7 mermaid (4 dataflow + 3 lifecycle) |
| 06 | 工具栈与强制CLI | meta-cli / canvas / dashboards / 6 mandatory 场景 |
| 07 | 反模式 | AP-1 到 AP-13 完整 |
| 08 | spawn工程 | 9 必备元素、模板、5 SP 反模式 |
| 09 | enforcement层 | Part 14 完整:mandatory CLI/canvas/operational play |
| 10 | skill-manager-spec | NEW post-commit skill 维护 agent |
| 11 | meta-meta-agent-spec | v0.1 + v0.2 plan + Dim 9 (v5.3) |
| 12 | 未来vision与roadmap | Phase 1-4 + maturity 1-5 |
| 13 | 自更新协议 | 谁/何时/如何更新本宪法 |
| 14 | consolidation-workflow | NEW 蒸馏工作流:递归能力、5 段结构、CLI + agent 职责分工 |
| 15 | team-member-patterns | NEW 2026-04-15: advisor / executor / evaluator 三 archetype 完整 spec + 跨域复用指南 |
| adr | 001 — Unified Meta + meta-coder layout | v5.1 activation ADR (2026-04-11): task+finding unified, data layer → .claude/meta-coder/ |
| ex-01 | Example 01 — Dogfood: skill-manager mapping 扩展 | 场景示例 + 3 mermaid (数据流/角色协作) |
阅读顺序建议
| 你是谁 | 读什么 | 时间 |
|---|---|---|
| Cold-start 新 Lead ← canonical | ADR-001 → 00 → 01 → 02 → 14 → 15 → 03 → 07 → 08 | ~40 分钟 |
| 知道 v4 的老 Lead | 本 SKILL → 01 (skill-manager 段) → 10 → 09 → 12 | ~15 分钟 |
| 想理解设计哲学 | 00 → references/motivation.md | ~45 分钟 |
| 要 spawn agent | 08 → 07 → 03 | ~10 分钟 |
| 高 stakes 决策前 | 04 → 07 (AP-13) | ~10 分钟 |
| 工具速查 | 06 | ~5 分钟 |
| 想合并元思考 | 本 SKILL → 14 → 11 (meta-meta) | ~10 分钟 |
| 设计 review (User) | 00 → 12 → 13 | ~20 分钟 |
| 想复用 advisor/executor/evaluator 到新领域 | 15 → task-meta-tower-distillation §4 → task-meta-workflow-continuation §10-§11 | ~20 分钟 |
| 想理解 team member 独立性原则 | 15 §15.2 → v5/01 §1.9 → 08 (spawn 工程) | ~15 分钟 |
v4 归档
v4 SKILL.md 已归档至 .claude/archive/2026-04-09-v4-to-v5/SKILL.md.v4。
v5 拆分文件位于 v5/ 子目录;v5 文件间的 cross-reference 使用相对路径
([01-角色与边界](01-角色与边界.md),因为它们在同一目录);从本 SKILL 进入 v5
文件需加 v5/ 前缀。
自更新
本入口索引由 Lead 在 v5 → v6 升级时更新,规则见 13-自更新协议。