# Guide Metal Coder Essence

> 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 元思考是否真的在被实施

- Skill: `cyl19970726/guide-metal-coder-essence` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add cyl19970726/guide-metal-coder-essence`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cyl19970726/guide-metal-coder-essence/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cyl19970726 (https://skillmd.com/u/cyl19970726)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cyl19970726/guide-metal-coder-essence

---


# metal-coder 本质：8 个元思考的演化序列

> **一句话**：metal-coder 由 8 个元思考演化构成。**每个元思考都从前一个推导出来——这本身就是一条 derivation chain，dogfood 元思考链方法论自身**。

---

## 8 元思考演化图

```mermaid
flowchart TD
    M01[01 解决什么问题<br/>Layer 1 / 北极星]
    M02[02 meta-think 定义<br/>如何用元思考推进工作]
    M03[03 meta-chain 本质<br/>溯源系统演化]
    M04[04 meta-chain 分叉机制<br/>5 类节点关系]
    M05[05 meta-tower<br/>合并 + 整理 + 纠错]
    M06[06 git PR 元思考<br/>外部协作 + CI/CD + review]
    M07[07 worktree 元思考<br/>真并行 + 节点分叉]
    M08[08 evaluator + evolve<br/>让系统真自我进化]

    M01 -->|因此需要| M02
    M02 -->|思考需要载体| M03
    M03 -->|载体需要并行| M04
    M04 -->|节点需要整理| M05
    M05 -->|个体需要协作| M06
    M06 -->|协作需要隔离| M07
    M07 -->|有了一切但缺反馈| M08
    M08 -.推动 1-7 进化.-> M01

    style M01 fill:#fff4e1
    style M08 fill:#e8f5e8
```

---

## 8 元思考一览表

| # | 元思考 | 一句话 | 当前状态 | 文档 |
|---|-------|-------|---------|------|
| 01 | 解决什么问题 | 长时间复杂工作里思考会消失，必须结构化为系统状态 | ✅ | [thinking/01-problem](./thinking/01-problem) |
| 02 | meta-think 定义 | 元思考 = ⟨察觉→推导→下一步⟩ 三段式 + 7 类 typology | ✅ | [thinking/02-meta-think](./thinking/02-meta-think) |
| 03 | meta-chain 本质 | 跨 session 思考的载体 + 溯源能力 | ✅ | [thinking/03-meta-chain-essence](./thinking/03-meta-chain-essence) |
| 04 | meta-chain 分叉 | 5 类节点关系（4 已实现 + 2 设计中）| ⚠️ partial | [thinking/04-meta-chain-forking](./thinking/04-meta-chain-forking) |
| 05 | meta-tower | 三种用法：合并 + 整理 + 纠错 | ✅ | [thinking/05-meta-tower](./thinking/05-meta-tower) |
| 06 | git PR | meta ↔ PR 双向 + CI/CD validators | 🧪 设计中 | [thinking/06-git-pr](./thinking/06-git-pr) |
| 07 | worktree | worktree 与 chain 集成 + 节点分叉 protocol | 🧪 设计中 | [thinking/07-worktree](./thinking/07-worktree) |
| 08 | evaluator + evolve | 3 层 evaluator + evolve 闭环 | 🧪 设计中 | [thinking/08-evaluator-evolve](./thinking/08-evaluator-evolve) |

**当前真实状态：3/8 完整实施 + 1 partial + 4 设计中**。

---

## 阅读顺序

| 你是谁 | 读什么 | 时间 |
|--------|--------|------|
| 第一次见 metal-coder | 01 → 02 → 03 → 05 → 08 | ~30 分钟 |
| 想理解 chain 怎么工作 | 03 → 04 → 05 | ~15 分钟 |
| 想实施 v0.2 | 04 + 06 + 07 + 08（设计中部分）| ~20 分钟 |
| 想评估"这个 PR 该不该做" | 用 §每个文档的 4-gate 审查 | 5 分钟 |
| 想理解为什么是 8 个不是 5 个或 12 个 | 演化图 + 每个文档的"derives_from" | ~10 分钟 |

---

## 核心原则（贯穿 8 元思考）

1. **每个元思考必须三段齐全**（察觉 / 推导 / 下一步）— 详见 02
2. **每个机制必须 forcing function**（不能纯靠 Lead 自律）— 详见 02 + 08
3. **evaluator 必须 independent cognitive locus**（不能 Lead 自评）— 详见 08
4. **evolve 必须 traceable**（每个改动追溯到 evaluator finding）— 详见 08
5. **任何新功能必须 derives_from 8 元思考之一**（否则是 nice-to-have）— 4-gate 审查

---

## 与其他资源的关系

```mermaid
flowchart LR
    Essence[guide-metal-coder-essence<br/>本 skill — 北极星]

    Essence -->|定义机制 1 原子| MT[guide-meta-thinking<br/>元思考方法论]
    Essence -->|定义机制 2-3 工作流| MAS[guide-meta-agent-system v5<br/>角色 + ritual + tower]
    Essence -->|定义协作载体| AT[guide-agent-teams<br/>TeamCreate API]
    Essence -->|定义日常 SOP| LDP[lead-daily-practice<br/>scenario → cli 映射]
    Essence -->|教学版| Docs[docs/meta-thinking/<br/>case 库]

    style Essence fill:#fff4e1,stroke:#080,stroke-width:3px
```

**本 skill 是上述所有的北极星索引**——读完才知道每个 resource 服务哪个元思考。

---

## 自更新协议

修改本 skill 必须满足两个条件：
1. 8 元思考中**某一个被证明不必要**或**第 9 个被证明必要**——这是非常高的 bar
2. 跨多个 work chain 的 evaluator finding 共同支持

只补充优化项 / 修订 case 例子 → 直接更新对应 thinking/*.md，不算"修改本 skill"。

