# Guide Meta Agent System > 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 规范。 - Skill: `cyl19970726/guide-meta-agent-system` (Agent Skill, multi-file: 20 files) - Install (CLI): `npx skillmds@latest add cyl19970726/guide-meta-agent-system` - Raw SKILL.md: https://api.skillmd.com/api/skills/cyl19970726/guide-meta-agent-system/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: cyl19970726 (https://skillmd.com/u/cyl19970726) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/cyl19970726/guide-meta-agent-system --- # guide-meta-agent-system v5 — 入口索引 > 本文件是导航。**不读它就不知道去哪**，**只读它什么都不会做**。 > 想做事 → 按下方阅读顺序跳到具体文件。 --- ## 北极星 (one sentence) Lead Claude 在单 session 上下文有限的前提下，**通过元思考链 + 7 角色协作 + 强制 ritual**，持续推进策略迭代和基础设施迭代，向自动化盈利系统收敛。 --- ## 核心概念（统一模型） 整个系统由 **三实体 × 三关系** 描述（详见 [14-consolidation-workflow §14.2.5](v5/14-consolidation-workflow.md#145-统一模型三实体--三角色--三关系)）: - **三实体**: **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/15-team-member-patterns.md)。 --- ## 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](v5/10-skill-manager-spec.md)) | | Dashboard | 散落 Part 7/14 | 集中到 [06](v5/06-工具栈与强制CLI.md) | | Sub-agent vs Agent Team | 概念混用 | 显式区分 ([01](v5/01-角色与边界.md) §对比表) | | Spawn prompt 可见性 | 不可见 | 提案 `meta-cli prompt ` ([06](v5/06-工具栈与强制CLI.md)) | | Cold-start 自评 | 8.5/10 | 目标 9/10 (拆分后单文件 < 600 行更易消化) | v5 触发原因: User 反馈 v4 单文件难导航 + cs2-v4 session 暴露 skill 漂移 + 缺少 post-commit skill 维护 agent。完整动机见 [00-设计出发点](v5/00-设计出发点.md)。 ### 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//`。 > **新 cold-start canonical 路径见下方"阅读顺序建议"表的 `Cold-start 新 Lead` 行。** | # | 文件 | 一句话 | |---|------|--------| | 00 | [设计出发点](v5/00-设计出发点.md) | 为什么这套系统存在；7 约束推导；v2→v5 演化 | | 01 | [角色与边界](v5/01-角色与边界.md) | 7 角色定义 (含 advisor)、对比表、operational play | | 02 | [元思考链](v5/02-元思考链.md) | 4 重身份、6 type、status 流转 + completed status (v5.3 补丁)、consolidation | | 03 | [标准ritual](v5/03-标准ritual.md) | Step 0 + Step 1-10 + Step 11，三层 lifecycle | | 04 | [辩证ritual](v5/04-辩证ritual.md) | 4 rounds + Round 5 Pivot | | 05 | [数据流图](v5/05-数据流图.md) | 7 mermaid (4 dataflow + 3 lifecycle) | | 06 | [工具栈与强制CLI](v5/06-工具栈与强制CLI.md) | meta-cli / canvas / dashboards / 6 mandatory 场景 | | 07 | [反模式](v5/07-反模式.md) | AP-1 到 AP-13 完整 | | 08 | [spawn工程](v5/08-spawn工程.md) | 9 必备元素、模板、5 SP 反模式 | | 09 | [enforcement层](v5/09-enforcement层.md) | Part 14 完整：mandatory CLI/canvas/operational play | | 10 | [skill-manager-spec](v5/10-skill-manager-spec.md) | NEW post-commit skill 维护 agent | | 11 | [meta-meta-agent-spec](v5/11-meta-meta-agent-spec.md) | v0.1 + v0.2 plan + Dim 9 (v5.3) | | 12 | [未来vision与roadmap](v5/12-未来vision与roadmap.md) | Phase 1-4 + maturity 1-5 | | 13 | [自更新协议](v5/13-自更新协议.md) | 谁/何时/如何更新本宪法 | | 14 | [consolidation-workflow](v5/14-consolidation-workflow.md) | NEW 蒸馏工作流：递归能力、5 段结构、CLI + agent 职责分工 | | 15 | [team-member-patterns](v5/15-team-member-patterns.md) | NEW 2026-04-15: advisor / executor / evaluator 三 archetype 完整 spec + 跨域复用指南 | | adr | [001 — Unified Meta + meta-coder layout](v5/adr/001-unified-meta-and-meta-coder-layout.md) | v5.1 activation ADR (2026-04-11): task+finding unified, data layer → `.claude/meta-coder/` | | ex-01 | [Example 01 — Dogfood: skill-manager mapping 扩展](v5/examples/01-dogfood-sop-format-fix.md) | 场景示例 + 3 mermaid (数据流/角色协作) | --- ## 阅读顺序建议 | 你是谁 | 读什么 | 时间 | |--------|--------|------| | **Cold-start 新 Lead** ← canonical | [ADR-001](v5/adr/001-unified-meta-and-meta-coder-layout.md) → 00 → 01 → 02 → 14 → 15 → 03 → 07 → 08 | ~40 分钟 | | 知道 v4 的老 Lead | 本 SKILL → 01 (skill-manager 段) → 10 → 09 → 12 | ~15 分钟 | | 想理解设计哲学 | 00 → [references/motivation.md](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-自更新协议](v5/13-自更新协议.md)。