# workflow:AI 开发协议(承接→分析→评审→执行→验证→沉淀)

> **类型**:元流程(workflows) · **简版规约**:[`../../AGENTS.md`](../../AGENTS.md) §5 工作协议(本文件是其操作化展开)。
> **何时用**:承接**任何** oh-my-muse 任务时先走本流程分流。核心立场:**机械门禁优先、完成=验证、反假绿**。
> **版本**:v1 · **更新日期**:2026-07-20 · **变更记录**:从未编号版本升级为 v1，新增创作智能体反序验证门禁与正文卡索引/原文回读双线。

---

## 〇、分流(先判复杂度)

| 路径 | 判据 | 流程 |
|---|---|---|
| **直通** | 简单 / 低危 / 局部 / 可清晰验证 | 目标 → 最小改动 → 验证 → 报告 |
| **全流程** | 复杂 / 高危 / 跨模块 / 改用户可见行为 / 触外部服务·支付·数据·模型 | 一~六全程 |

---

## 一、承接
- 读 [`../../AGENTS.md`](../../AGENTS.md) → [`../README.md`](../README.md);用 [`../knowledge/`](../knowledge/) 对齐事实(定位/架构/真实现状/决策),用 [`../rules/`](../rules/) 划红线。
- 涉及历史现状先查 [`../knowledge/module-reality-baseline.md`](../knowledge/module-reality-baseline.md),**避免重复探索**。
- 复杂任务:先**复述理解**(目标 / 边界 / 非目标)。

## 二、分析
- 第一性原理 + 金字塔:问题、边界、假设、风险、推荐路径。
- 区分**已验证事实 / 推断 / 假设**;只读可得的先查代码·文档·配置·测试·日志,再问人。

## 三、评审(仅全流程)
- 评审版 spec:`docs/agent-specs/YYYY-MM-DD-主题-review.md`(**结论先行**,只留背景/目标/非目标/推荐方案/权衡/影响面/风险/验收/待确认)→ **两轮评审** → 执行版 `...-execution.md`(目标边界/前置/涉及文件/数据流/契约/步骤/失败路径/验证法/完成条件/回滚)。

## 四、执行
- **最小改动**:只动相关代码,复用既有模式,不顺手重构。
- **无孤儿/拼接**:任何新结构/接口/模型须带入口、使用路径、失败路径、验收标准。
- 全简体中文注释;外部交互/核心实现/错误路径留可追溯日志。
- 契约先行(见 [`../rules/contract-first.md`](../rules/contract-first.md));守 BC 边界(见 [`../rules/bc-boundaries.md`](../rules/bc-boundaries.md))。

### 创作智能体反序验证门禁

- **能力验证顺序固定**:清洗/抽卡/范式 → 正文 Gate B → 细纲 → 大纲+设定。正文 Gate B 未由唯一判定器输出 `passed` 前,不得启动细纲智能体真实能力验收;单章、单作品、Gate A 或人工观感都不能替代 Gate B。
- **正式创作数据流不倒置**:产品运行仍是大纲+设定 → 细纲 → 正文。反序只用于能力隔离与归因,不能让实验评测产物反写正式设定、Canonical 状态、细纲或正文。
- **正文双线固定**:抽取卡只作索引,命中后必须按来源引用回读冻结线内原文。卡线负责定位事实与历史场景,原文线负责人物声音、动作习惯、能力表现和叙事质感;无来源卡不得单独支撑正文硬事实。
- **独立权威事实**:作者确认的正式设定、冻结点可见的 Canonical 状态、已确认细纲声明的新事实直接引用各自不可变版本,不要求伪造抽取卡或历史原文来源。
- **阶段边界**:正文实验阶段不改产品 API、Flyway、业务数据库或 Canonical 主链。只有正文 Gate B=`passed` 后,才另立产品化计划和后续细纲验收计划。

## 五、验证(证据门 —— 不可跳过)
- **完成 = 机械验证**;无自动化绿证据**不得**声称“完成/修复/通过”(见 [`../rules/verification-and-anti-false-green.md`](../rules/verification-and-anti-false-green.md))。
- 用户可见功能按 [`../skills/golden-journey-vertical-slice.md`](../skills/golden-journey-vertical-slice.md) 的**三指标**报告(代码 / 自动化验证 / 端到端可用),不给单一百分比。
- 关键门禁须绿:BC(`BcBoundaryArchTest`)、契约(`ContractFirstGateTest`)、CI 真跑测试(JDK21)。
- **构建纪律(实证教训)**:① 勿并发跑多个 `mvn` 写同一 `target`(会致 `NoSuchFileException` 假错);② 勿信退出码 / 末尾 `grep` 掩盖——读 `BUILD SUCCESS` + `Tests run / Failures` 真实行;③ JDK21 经 `mise exec` 锁定。

## 六、沉淀(复利来源 —— 也是硬约束)
- 把可复用产出回写 [`../`](../) 对应层:新事实→`knowledge/`;新硬约束(**必配机械门禁**)→`rules/`;新操作手册→`skills/`;流程改进→本 `workflows/`。
- 先查重再新增;过时即修正/删除;结构性变更**同步 [`../README.md`](../README.md) 与 [`../../AGENTS.md`](../../AGENTS.md) 索引**。
- 进度进总账 + per-module `.agent`(建设中),**不再新增“状态推进”过程文档**(churn 是失控来源之一)。
- 交付后按需询问:是否将关键信息持久化到 `docs/memorys/` 或 `docs/agent-specs/`。

---

> 一句话:**先对齐事实、划红线,再动手;动手必最小、必留证据;完成必机械验证、必沉淀。**