oh-my-muse/.agents/workflows/ai-development-protocol.md

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

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

---

〇、分流(先判复杂度)

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

---

一、承接

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

二、分析

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

三、评审(仅全流程)

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

四、执行

• 最小改动:只动相关代码,复用既有模式,不顺手重构。
• 无孤儿/拼接:任何新结构/接口/模型须带入口、使用路径、失败路径、验收标准。
• 全简体中文注释;外部交互/核心实现/错误路径留可追溯日志。
• 契约先行(见 ../rules/contract-first.md);守 BC 边界(见 ../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)。
• 用户可见功能按 ../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 与 ../../AGENTS.md 索引。
• 进度进总账 + per-module .agent(建设中),不再新增“状态推进”过程文档(churn 是失控来源之一)。
• 交付后按需询问:是否将关键信息持久化到 docs/memorys/ 或 docs/agent-specs/。

---

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