// 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 规范。
metal-coder 的北极星定义 —— 8 个元思考组成的演化序列，构成项目本质。 从"我们解决什么问题"开始，到"系统怎么自己进化"结束， 每个元思考都 derives_from 前一个，本身就是一条 derivation chain。 **所有其他 skill / cli 命令 / docs 都是这 8 个元思考的具体化或优化。** 读完本 skill 才算真正理解 metal-coder。 必须加载场景： (1) 第一次接触 metal-coder（在 docs/ 之前先读本 skill） (2) 设计任何新功能 / 新命令前 — 先确认它服务哪个元思考 (3) 评估"这个改动是不是核心"— 用 8 元思考序列对照 (4) 想理解 metal-coder 与 v5 / docs/ / lead-daily-practice 的关系 (5) 跨 work chain 反思时 — 检查 8 元思考是否真的在被实施
metal-coder 项目内 Lead 的日常操作 SOP —— 把元思考定义 + meta-cli 11 命令 + Tower 蒸馏组合成可执行的 7 步流程。 必须加载场景： (1) 在 metal-coder 项目（/home/hhh0x/metal-coder/）内推进任何工作 (2) 不知道某个场景该调哪个 meta-cli 命令 (3) 写完一个 meta 文件，需要自检是否合格元思考 (4) chain 累积 ≥5 metas，考虑是否 Tower distill (5) 决定是否 fork 一个工作为多个 sub-chain 本 skill 是元思考定义（docs/meta-thinking/）和 meta-cli 命令实现的 bridge 层。 没有它，Lead 会 default 手写 metas 而不调 cli，工具不被使用价值流失。
Claude Code Agent Teams 完整使用指南：多 session 协作、共享任务、inter-agent 通信。 包含 Lead 管理方法论（Spawn 设计原则、协调模式、纠正策略、知识提取时机）。 使用场景：(1) 创建和管理 agent team (2) 设计 spawn prompt 和角色分工 (3) 理解 tools API（TeamCreate/SendMessage/Task*/EnterPlanMode） (4) 排查 agent teams 问题（teammate 不出现、权限、shutdown） (5) 对比 subagents vs agent teams 选型 (6) Lead 准备创建 agent team 前参考 spawn prompt 设计清单 (7) 协调并行 agents 时选择合适的协调模式 (8) Agent 偏离任务时应用 3-level 纠正策略 (9) 决定何时提取知识到 guide-*/observe-* skills
元思考（MetaThink）方法论：从第一性原理推导系统行为，而非机械查文档。 核心是理解"为什么这样设计"而非"它是什么"，从设计约束推导出不可消除的行为边界， 用这些边界作为代码正确性的 eval 标准，并区分"我们的 bug"与"系统的固有限制"。 有以下意图时必须加载此 skill： (1) 不知道某个行为是 bug 还是系统正常行为 → 用元思考做 fault attribution (2) 面对新的技术系统，需要快速建立正确的心智模型 → 用元思考推导约束 (3) 对一段代码有多种实现方式，不知道哪种正确 → 用元思考找 eval 标准 (4) reconcile 发现异常，不确定根因 → 用元思考的约束链追溯 (5) 需要理解为什么 guide-polymarket-fundamentals 这样设计 → 读本 skill
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. Also use for Earning Engine PM v2 skill creation — task-* skills (development tasks), strategy-* skills (trading strategy lifecycle), observe-* skills (analysis reports), guide-*/map-* skills (knowledge docs). When users say "create a task", "plan a new feature", "analyze architecture", "write a guide", or "develop a new strategy", use this skill to route to the appropriate PM v2 template.
| 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-09T00:00:00.000Z" |
| supersedes | ["guide-meta-agent-system v4"] |
本文件是导航。不读它就不知道去哪，只读它什么都不会做。 想做事 → 按下方阅读顺序跳到具体文件。
Lead Claude 在单 session 上下文有限的前提下，通过元思考链 + 7 角色协作 + 强制 ritual，持续推进策略迭代和基础设施迭代，向自动化盈利系统收敛。
整个系统由 三实体 × 三关系 描述（详见 14-consolidation-workflow §14.2.5）:
不要忘: 后续所有 ritual / CLI / agent spec 都是这些原语的具体实例化。
三种 team-member archetype（advisor / executor / evaluator）的完整 spec + 跨域复用见 15-team-member-patterns。
| 维度 | 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.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) |
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 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-自更新协议。
