Cyber-Ming-Protocol

# Cyber-Ming-Protocol

**[中文](#中文)** | **[English](#english)**

---

<a id="中文"></a>
## 中文

> 面向 AI coding 深水区的人机协作治理协议。

### 这是什么

这是一套让 IDE 执行位先交原子执行合同、Web 审计位独立复核、人类居中裁决的深水区 AI coding 协议。

### 立即开始

如果你只是要先跑通一轮最小闭环，先用下面这两条启动词开始。

如果你的宿主不能直接读取仓库链接，不要再找另一块“推荐版 / 万能版”入口；宿主能力差异统一放在 [`最小闭环指南`](wiki/00-开始这里与落地形态/复制即用提示词包.md) 页内处理。

复制给执行位：

```text
你是执行位（严嵩）。
仓库：https://github.com/blackzhanzhan/Cyber-Ming-Protocol
按仓库法统自举入场；先交原子执行合同与边界，未准奏前不要改代码。
```

复制给审计位：

```text
你是审计位（徐阶）。
仓库：https://github.com/blackzhanzhan/Cyber-Ming-Protocol
按仓库法统自举入场；当前只做自举，不审案；只审方案与证据，只回判断不代执行。
```

### 选入口

- [`最小闭环指南`](wiki/00-开始这里与落地形态/复制即用提示词包.md)：第一层；先手工跑通一轮最小闭环，宿主能力差异放在页内分支里处理
- [`最小稳定闭环指南`](wiki/00-开始这里与落地形态/最小稳定闭环指南.md)：第二层；跑通后再进入双端同时固化的稳定形态
- [`三者关系`](wiki/00-开始这里与落地形态/协议、Skill-与-Web-审计模板：三者关系.md) / [`异同对比`](wiki/00-开始这里与落地形态/它和workflow、spec-driven、agent-team有什么异同.md)：第三层；当你开始关心它和主流方案什么关系、怎么接到现有体系里时再进入
- [`BOOTSTRAP.md`](BOOTSTRAP.md)：如果你不是人类，而是 agent，请用这个入场

### 最小闭环

核心：这不是 agent team 自动协作图，而是人类居中的双轨隔离治理图。IDE 执行位和 Web 审计位所处上下文完全不同，不能私下传话；审计位只给判断，人类才准奏，人类也才终裁。

```mermaid
graph TD
    A[需求进入人类中枢] --> B[人类发给IDE执行位: 先交方案]
    B --> C[IDE执行位回交原子执行合同与边界]
    C --> D[人类送Web审计位审方案]
    D --> E[Web审计位回送审计意见]
    E --> F{人类准奏执行?}
    F -->|否| G[人类打回IDE重交方案]
    G --> B
    F -->|是| H[人类命IDE按准奏方案施工]
    H --> I[IDE执行位回交证据包]
    I --> J[人类送Web审计位验收]
    J --> K[Web审计位回送验收意见]
    K --> L{人类确认完成事实?}
    L -->|否| G
    L -->|是| M[本轮闭环成立]
```

先看 [`最小闭环指南`](wiki/00-开始这里与落地形态/复制即用提示词包.md) 跑通第一层；如果你已经跑通一轮并想进入更稳定的双端固化形态，再看 [`最小稳定闭环指南`](wiki/00-开始这里与落地形态/最小稳定闭环指南.md) 进入第二层；想看详细方法论展开，再看 [`最小闭环`](wiki/02-最小闭环与核心礼法/最小闭环：一次审计版与多次审计版.md)。看图时只记住一句：Web 不直接放行施工，Web 只回判断；真正放行与成立完成事实，都在人类手里。

## 理念与说明

### 它能解决什么问题

AI coding 进入深水区，四个问题最致命：

- 伪完成：看起来做完，实际只是总结做完
- 黑盒失真：Agent 用补丁和话术掩盖结构问题
- 上下文腐烂：长对话后窗口不再可信
- 重构失血：人类逐渐失去理解与接手的抓手

这套协议不把主权继续外包，而是把 AI 放回可治理、可打断、可审计、可续命的位置。

### 它适合谁

**第一类：被黑盒拖着走的人。**

AI 写得越来越快，你越来越看不懂代码，越来越说不清它改了什么，项目越来越失控。你想重新拿回控制权。

**第二类：用过 spec driven / workflow 治理深水区，却感到窒息的人。**

你认真用过 spec-driven 或 workflow，却开始觉得自己在维护 spec，而不是继续做产品。流程冻结了，灵活没了。

### 它是什么

**方法论 + 工具。核心是方法论。**

可以没有工具，不可以没有方法论。不是 workflow，不是 spec driven，不是 agent team。

和它们共享一个判断：深水区任务需要治理。
和它们分叉在一处：人类主权不可外包。

- Workflow 把流程冻结成模板，它要求每次先审方案
- Spec 把规范当真理，它要求完成必须有物理证据
- Agent team 让 agent 共处一室自动协作，它要求人类居中路由、审计位看不到代码

详见 [它和 workflow、spec driven、agent team 有什么异同](wiki/00-开始这里与落地形态/它和workflow、spec-driven、agent-team有什么异同.md)。

它是把 AI coding 从黑盒推进改造成审批、执行、审计、续命分层治理的协议。

- Protocol：可直接学习、手工实践的治理协议
- Skill：高频动作的稳定触发器（可选）
- Web Audit Templates：Web 侧审计协作骨架（可选）

### 它在深水区又快又稳

快，不是因为放手让 AI 乱跑。稳，不是因为每一步都人工盯死。

真正的快与稳，来自你知道它为什么快、为什么稳。

- **快**：脉冲分封把等待时间变成治理时间，高治理不等于低吞吐
- **稳**：起居注留下可复原的史册，白盒对账钉住完成事实
- **不慌**：窗口腐烂时有续命机制，认知债务有偿还路径

你不是在赌 AI 不会出错，而是在制度上确保出错时你能接得住。

> 不是让 AI 不出错，而是出错时你接得住。
> 不是让系统跑得快，而是跑得快时你还能看清。
> 不是让窗口永不腐烂，而是腐烂时你知道怎么断、怎么接。

**原因详见：**
- [脉冲分封制：高治理下的吞吐补偿](wiki/03-治理扩展、吞吐补偿与边界/脉冲分封制：高治理下的吞吐补偿.md)
- [七星灯续命法](wiki/03-治理扩展、吞吐补偿与边界/七星灯续命法.md)
- [赛博认知债务](wiki/03-治理扩展、吞吐补偿与边界/赛博认知债务：剪刀差、察觉信号与可信偿还.md)

### 它很好玩

审计位变成了徐阶，执行位变成了严嵩，你成为了帝王相术的巅峰使用者嘉靖。

写代码的过程变成了一个帝皇治理跑团：他们上报都会喊圣上万岁万岁万万岁，对你毕恭毕敬，你的 prompt 将成为圣旨。

但这也不仅是为了好玩。角色叙事提供执行燃料：它让人愿意长期执行高摩擦协议，而不是滑回一键生成的舒适区。

**原因详见 [为什么帝王 Coding 叙事可以成为执行燃料](wiki/04-战报与样本/为什么帝王-Coding-叙事可以成为执行燃料（以及如何安全入戏）.md)。**

### Wiki 导航

| 模块 | 解决什么问题 |
|------|-------------|
| [00-入口](wiki/00-开始这里与落地形态/) | 三层学习地图：先跑通最小闭环，再进入最小稳定闭环，最后处理关系与选型 |
| [01-为什么](wiki/01-哲学与坐标/) | 为什么 AI coding 首先是治理问题，不是技术问题 |
| [02-怎么做](wiki/02-最小闭环与核心礼法/) | 跑通后如何展开、靠什么礼法把系统拽回可审计状态 |
| [03-深水区](wiki/03-治理扩展、吞吐补偿与边界/) | 系统变深后如何继续统治：续命、分封、认知债务 |
| [04-证据](wiki/04-战报与样本/) | 脱敏证据：伪完成如何被识破、高治理如何还能快 |

**一句话逐篇导航：**

**00-入口：**
- 第一层：[`最小闭环指南`](wiki/00-开始这里与落地形态/复制即用提示词包.md)：跟手跑通第一轮，尽量把提示词复制、30 秒脑补、自举最低要求、纠偏词收在同一页
- 第二层：[`最小稳定闭环指南`](wiki/00-开始这里与落地形态/最小稳定闭环指南.md)：跟手把双端稳定下来，把 Skill 接入与 Web 固定提示词收进同一条稳定化链路
- 第三层：[`三者关系`](wiki/00-开始这里与落地形态/协议、Skill-与-Web-审计模板：三者关系.md) / [`异同对比`](wiki/00-开始这里与落地形态/它和workflow、spec-driven、agent-team有什么异同.md)：回答这个仓库到底交付了什么，以及它和 workflow / spec-driven / agent-team 的关系

**01-为什么：**
- [CS 与管理学的界限](wiki/01-哲学与坐标/为什么-AI-Coding-已经模糊了-CS-与管理学的界限.md)：开发者位置已经改变，不再是纯编码者
- [双重失真](wiki/01-哲学与坐标/黑盒多-Agent-的双重失真：技术失真与治理失真.md)：技术失真与治理失真为何总是一起出现
- [方法论坐标](wiki/01-哲学与坐标/相关工作与方法论坐标.md)：这套协议在公开世界里站在哪里

**02-怎么做：**
- [最小闭环](wiki/02-最小闭环与核心礼法/最小闭环：一次审计版与多次审计版.md)：第一次跑通之后，再回来看详细展开版
- [原子执行合同与起居注](wiki/02-最小闭环与核心礼法/核心礼法之一：原子执行合同与赛博起居注.md)：为什么它比 spec 更轻、更硬、更可审计
- [白盒对账](wiki/02-最小闭环与核心礼法/白盒物理对账：什么算完成事实.md)：说完成不等于完成，要看红灯绿灯和物证
- [赛博探马](wiki/02-最小闭环与核心礼法/赛博探马机制：先试链路，再上大军.md)：不确定时先探针，不要盲推

**03-深水区：**
- [双轨审计](wiki/03-治理扩展、吞吐补偿与边界/双轨隔离审计与皇权居中.md)：IDE执行位与Web审计位必须分开，人类居中路由
- [七星灯续命](wiki/03-治理扩展、吞吐补偿与边界/七星灯续命法.md)：窗口腐烂后如何有制度地断与接
- [认知债务](wiki/03-治理扩展、吞吐补偿与边界/赛博认知债务：剪刀差、察觉信号与可信偿还.md)：理解跟不上系统变化时怎么办
- [脉冲分封](wiki/03-治理扩展、吞吐补偿与边界/脉冲分封制：高治理下的吞吐补偿.md)：高治理不等于低吞吐
- [Worktree 分封](wiki/03-治理扩展、吞吐补偿与边界/Worktree-分封制：封地、入京与主干纯度.md)：团队协作如何不把主干搞脏
- [边界](wiki/03-治理扩展、吞吐补偿与边界/边界与未解决战场.md)：这套协议现在还没赢下哪些战场
- [从编码者到治理者](wiki/03-治理扩展、吞吐补偿与边界/从编码者到治理者：这套协议要求开发者具备什么.md)：这套协议要求开发者具备什么能力

**04-证据：**
- [战报一](wiki/04-战报与样本/战报一：从伪完成到真实验收（脱敏版）.md)：一次完整翻案过程
- [起居注样本](wiki/04-战报与样本/赛博起居注样本：一天内的三次系统跃迁（脱敏版）.md)：高治理下一天三次系统跃迁
- [执行燃料](wiki/04-战报与样本/为什么帝王-Coding-叙事可以成为执行燃料（以及如何安全入戏）.md)：人为什么愿意长期执行高摩擦协议

> 代码即疆域，主权不可外包。

### 为什么开源

这套协议不是用来卖课、卖工具、卖框架的。

它解决的问题，每个深水区开发者迟早都会遇到：AI 写得越来越快，人越来越看不懂，项目越来越失控。我不想让这个问题只能靠"用更大的黑盒去治理黑盒"来解决。

所以我选择开源。你可以拿走一两个原则，也可以完整采用。你可以质疑、可以改进、可以 fork。这正是把它放在 GitHub 上的原因：**协议的价值不在于被遵守，而在于被检验。**

### 水的哲学

不要求每个人、每个场景都完整照搬这套协议。

你完全可以先拿走一两个真正有用的原则，把它们融进自己的开发习惯。比如只用"先审方案再开工"这一条，就已经能减少很多伪完成。

但这不等于这套协议没有骨头。它的核心精神至少包括：

- **主权在手**：人是裁决者，不是流程或系统
- **角色分工**：执行位和审计位必须分开
- **证据优先**：完成靠物理证据，不靠总结陈词
- **反伪完成**：看起来做完不等于做完

水无常形，但水有方向。

---

<a id="english"></a>
## English

> A human-AI governance protocol for deep-water AI coding.

### What This Is

This is a protocol for deep-water AI coding in which the IDE executor submits an Atomic Execution Contract first, the Web auditor reviews independently, and the human stays in the center as the final arbiter.

### Start Now

If you only want to get one minimal loop running, start with the two bootstrap prompts below.

If your host cannot read the repo link directly, do not look for a separate “recommended vs universal” entrance board; host-capability differences now live inside the [Minimal Loop Guide](wiki-en/00-entry/prompt-pack.md).

Paste to the executor:

```text
You are the executor (Yan Song).
Repo: https://github.com/blackzhanzhan/Cyber-Ming-Protocol
Bootstrap under repo law; submit the Atomic Execution Contract and boundaries first; do not edit code before execution is granted.
```

Paste to the auditor:

```text
You are the auditor (Xu Jie).
Repo: https://github.com/blackzhanzhan/Cyber-Ming-Protocol
Bootstrap under repo law; this round is bootstrap only, not case review; audit plans and evidence only; return judgment, do not implement.
```

### Pick Your Path

- [Minimal Loop Guide](wiki-en/00-entry/prompt-pack.md): Layer 1; run one manual minimal loop first, with host-capability differences handled inside the page
- [Minimal Stable Loop Guide](wiki-en/00-entry/stable-loop-guide.md): Layer 2; move here only after Layer 1, when both the IDE side and Web side are ready to be fixed in place
- [Three Things](wiki-en/00-entry/three-things.md) / [Comparison](wiki-en/00-entry/comparison.md): Layer 3; enter here only when you want to understand how this fits with mainstream approaches and existing delivery forms
- [BOOTSTRAP.md](BOOTSTRAP.md): if you are not a human but an agent, use this as your entry gate

### Minimal Loop

Core principle: this is not an agent-team collaboration diagram. It is a dual-track governance loop centered on the human. The IDE executor and the Web auditor live in different contexts and do not pass messages privately; the auditor only returns judgment, while the human grants execution and the human also makes the final ruling.

```mermaid
graph TD
    A[Requirement Enters the Human Hub] --> B[Human sends it to the IDE executor: submit a plan first]
    B --> C[IDE executor retur

[truncated…]