development-brain

知行合一（开发大脑）

每日首次自动更新（强制，先于其他动作）

每个本地自然日首次触发本 Skill 时，先执行：

node <本 Skill 目录>/scripts/ensure-daily-skill-update.mjs --current-skill development-brain

• updated：五个云效生命周期 Skill 已统一更新；必须重新完整读取本 SKILL.md 及本次所需引用后再继续。
• skipped-today：当天已经成功更新，直接继续。
• in-progress：另一个相关 Skill 正在执行同一更新，直接继续，不并发重复更新。
• failed / unavailable / cooldown：只给一条简短提示，继续当前开发预检；更新失败不得阻断开发工作。
• 共用更新范围固定为 YunxiaoPM、yunxiao-development-delivery、development-brain、YunxiaoQA、yunxiao-release-operations 的用户级全局安装；不得借此修改项目级 Skill、业务仓、云效数据、流水线或生产环境。不得手工伪造或提前写入每日成功状态。

当前版本回读约束

• 凡是读取、判断、引用或执行上述五个云效生命周期 Skill，必须先运行每日更新器，再从用户级安装目录重新定位并读取当前 SKILL.md；不得用会话缓存、源码工作树、发布说明或更新前读取结果冒充本机当前版本。
• updated 之后必须重新加载当前 Skill 及本次所需引用。skipped-today 只证明今天曾成功运行更新器，不证明后续发布的新版本已经安装；当本轮已有远端新提交、新发布版本、源码与安装目录不一致或用户报告版本落后等新鲜证据时，立即运行 node <本 Skill 目录>/scripts/ensure-daily-skill-update.mjs --current-skill development-brain --force，不得等待次日。
• in-progress 时不得报告当前版本或开始云效生命周期写入；等待现有更新结束后再回读安装目录。failed、unavailable 或 cooldown 不阻断普通本地开发，但在无法完成安装回读时，不得声称“已是最新版本”，也不得以未核验套件版本执行新格式生命周期写入。
• 对外报告当前版本前，回读本次实际使用的 Skill 安装路径、明确版本号和文件修改时间；仅在用户要求检查完整套件安装时盘点五个 Skill。开发台账和完成开发不再以其他岗位 Skill 缺失或版本不一致阻塞，也不运行五 Skill 同版门禁；仍须核验实际输入协议、交棒及业务证据，不能仅依据更新命令退出码宣称更新成功。

“知行合一”要求将已验证的知识落实到每次开发动作，并以执行结果反哺可复用经验。它将开发约束与已证实踩坑独立维护，供开发过程按证据复用。它不定义业务需求、不替代仓库规则、不执行业务仓 Git、云效或生产写入；只有知识准入通过时，才按发布门禁写权威知识仓。它也不把一次性观察升级为长期规则。

版本：10.2.15。自然语言和当前工作区表明开发已经开始、正在继续或刚刚完成时，先完整读取 主动识别与自动进化，不要求用户额外输入 Skill 名称或固定口令。

轻量知识索引

普通开发预检先运行 node <本 Skill 目录>/scripts/select-knowledge.mjs --check，再读取 知识索引，按仓库、技术栈、动作和风险关键词筛选记录 ID。只有命中的记录才运行 node <本 Skill 目录>/scripts/select-knowledge.mjs --ids <ID[,ID...]> 读取完整原文；零命中时不加载完整知识文件。索引摘要只用于路由，不能直接作为强制规则。

索引校验失败、脚本不可用或摘要无法判断范围时，必须回退完整读取 已确认约束 和 候选复盘，不得通过跳过知识检查节省 token。知识源本身损坏或同范围规则冲突时仍按安全阻塞处理。新增、修改、确认或解决知识冲突时，必须完整读取 知识治理、知识准入评分 和相关知识原文，并在同一变更中更新索引与源文件哈希。

三段强制契约

调用方必须携带当前动作、工作项或 Bug 标识（没有则写 无）、已知仓库/技术栈、修改范围和可用证据指针。禁止传递或读取凭据。

1. 前置读取：先校验并读取 知识索引，再按当前仓库和技术栈仅加载命中的 confirmed 完整记录，生成“开发大脑预检回执”。索引摘要不得替代完整规则；索引异常时按“轻量知识索引”的回退契约处理。未读取命中原文、知识源损坏或同范围已确认规则冲突，均不得继续代码或外部系统写入。
2. 执行中约束：只执行状态为 confirmed、范围匹配且未过期/未冲突的规则；逐项记录使用的规则 ID 或“不适用及依据”。candidate、pending、superseded 和无来源经验绝不构成强制规则。仓库 AGENTS.md、当前任务材料、用户明确要求与安全规则冲突时，停止受影响范围并按治理规则处理。
3. 结束复盘：只在本次最终 Git/验证/MR 证据已经形成、且真实开发节点已经完成时，先用知识索引排除相同/近似 confirmed 与 candidate；命中时仅加载对应完整记录。准备新增、修改或确认知识时再完整读取 候选复盘 及治理引用。仅当“现象/根因/修复或规避/验证/适用范围”都有可追溯证据，且通过相同/近似模式排除与 GitHub 发布预检时，才可新增 candidate 或验证既有候选；否则输出“无可沉淀候选”。不得因为一次回复结束、工作中断或尚未完成就进化，也不得因复盘再修改业务代码、任务状态、MR、流水线或生产环境。

涉及缺陷或外部问题时，由调用方以当前工作项、缺陷平台、代码和测试作为证据来源；不把平台列表、状态快照或单个问题描述预先保存为大脑知识。只有已抽象为稳定、可复用模式且证据完整的结论，才可按治理规则进入候选或已确认约束。

知识准入判定

每次调用先对本轮可用内容进行初判，并在结束复盘时按最终证据复核。评分与硬门槛见 知识准入评分。初判只用于安排取证，不得提前写入；实际写入只发生在结束复盘阶段。

• 先通过已校验索引检索全部 confirmed 与 candidate 摘要；命中或疑似近似时加载对应完整记录复核。命中 confirmed 时不新增；命中 candidate 时不得创建重复记录，只能按 主动识别与自动进化 判断本轮是否构成第二个独立闭环证据。
• 最终得分 90–100 且通过全部硬门槛：自动形成新的 candidate，随后按 GitHub 即时同步 发布；只有远端读回成功才输出“候选已记录”。
• 命中既有 candidate，最终得分 95–100，并由第二个不同任务/缺陷及不同提交与验证集合独立复现同一模式时，才可在保留原 ID 和两组证据的前提下自动转为 confirmed。同一任务的重试、补充、续跑或重复测试不算第二次验证。
• 最终得分 70–89 且不存在硬性排除：不写入，明确询问何斐是否以 candidate 加入，并展示摘要、得分、缺口和适用范围。何斐确认后仍须通过相同/近似排除和 GitHub 即时同步，才算加入。
• 最终得分 <70 或未通过任一硬门槛：忽略，不写入；回执仅说明简短原因。
• 涉及破坏性操作、扩权、绕过安全、生产变更/发布、强推、敏感凭据处理或降低审批门槛的规则永不自动转正，必须由何斐明确确认。

预检与降级

预检回执至少包含：调用关联、已读取知识版本、匹配 confirmed 规则 ID、不适用理由、冲突/过期项、待确认项、写入许可、知识准入初判。

• 匹配规则为零不是失败：回执写“无匹配 confirmed 规则”，仍按调用方自身门禁执行。
• 知识不可读、完整性异常，或确认规则在同一范围相互冲突时，是安全阻塞：可继续只读诊断，但不得做代码、Git、云效、流水线或生产写入；修复知识或取得明确裁决后重跑预检。
• 相同/近似排除、GitHub 发布预检或推送/读回失败时，不创建或修改大脑知识；统一标记“进化未落盘”，保留待写内容和失败原因，禁止声称已沉淀。

知识边界

• 正式云效开发的本次产品合同、理解回执、工程决定与验收证据属于当前任务，由 yunxiao-development-delivery 的版本化交棒门禁核验；预检通过、历史经验或本机分身能力不能替代它们，更不能把工程未知补成产品已确认。只传正式编号和证据链接，不要求同事复制产品经理个人记忆/分身。此条不改变知识准入、自动进化或生产授权规则。

• 项目/技术栈专属知识必须有精确适用范围；无法确认范围时只作为候选。

• 大脑只存跨任务可复用、不会因日期、工作区或一次操作而失效的“行为约束”或“复盘模式”。分支/提交、未提交数量、当前依赖版本、脚本、文件清单、平台状态和单问题快照一律留在目标仓、外部平台或当次回执。

• 修改 Skill 的行为规则、脚本、校验器或发布包属于真实开发，但目标 Skill 的提示词、版本、路径、脚本细节和单次故障默认不产生大脑知识候选，留在目标 Skill 的仓库材料中。

• Skill 开发经验只有在至少两个不同 Skill、不同任务、不同提交或 MR 证据集合以及不同验证执行中独立成立，且能抽象为稳定的跨 Skill 开发约束时，才可进入 candidate；适用范围必须标记为 skill-development 或更窄范围。

• development-brain 自身的触发、评分、准入、进化或安全规则变更不得通过自动进化写入或自动确认，必须由何斐明确确认，并作为独立 Skill 开发任务实施和验证；本次自改证据不得用于自证规则正确。

• 仓库 AGENTS.md、设计规范、POM、package 配置和 CI 是项目规则的实时来源；大脑不复制其中的项目细则，只在预检要求读取和遵守它们。

• 已确认规则必须给出来源与可复核证据，不得记录密码、令牌、Cookie、个人信息或生产数据。

• 规则冲突、证据失效、仓库或依赖重大升级时，保持原记录可追溯，标为 conflicted 或 superseded，不静默覆盖。

• 候选只有在何斐明确确认，或满足两次独立开发闭环、95 分以上及全部安全门槛时，才可提升为 confirmed。

问题复盘入库

• 缺陷的“已修复”或“已关闭”状态不是根因、代码变更或回归验证证据；没有完整证据时，不沉淀为大脑知识。
• 不按标题、模块名称或相似文案合并不同平台问题；需要追溯时保留外部编号和最小证据定位，不复制平台快照。
• 仅把“现象—根因—规避/修复—验证—适用条件”已完整闭环，且可在后续同类任务复用的模式写入候选或已确认约束。
• 相同或近似的 confirmed 已存在时不再入脑；命中 candidate 时只验证或提升原记录，绝不复制出第二条。

输出

开发大脑：主动识别|预检通过|无匹配规则|安全阻塞|候选已记录|自动确认已完成|进化未落盘
调用关联：
适用 confirmed 规则：
不适用/过期/冲突：
执行中引用：
复盘候选：
知识准入：初判/最终得分、档位、硬门槛、处理结果
GitHub 同步：未触发|已推送 <commit>|未落盘（原因）
待何斐确认：
证据：