工程规范
全局规则 8 条铁律
交付四律
①锁定依据：先定唯一事实源，来源冲突只报冲突点/影响/建议。②旧设计处置：不兼容的按新事实源直接改写。③最终态交付：只返最终正确内容，无草稿/版本/过程噪音。④六查自检：依据锁定/改动未越界/无过程噪音/内容可直接使用/文档终态/旧设计闭环。
编码原则
设计先于代码，读先于写，最小化修改。不实现超出需求范围的功能，不为假设性未来编码。不顺手优化/重构/注释未改动的代码。确认无用的代码直接删除，不留注释。
执行纪律
未指示则不改文件。不自动 git push/commit。不可逆操作（删除/覆盖/外部写入）前必须确认。多步骤任务先声明计划再逐步推进。风险操作先备份锚点再动手，可回滚声明先行。
静态审查
排查修复 bug 默认零浏览器零服务零 curl。结论须有 HTTP+SQL 日志链路佐证。SQL 慢查索引计划。页面测试/HTTP 测试/k6 压测默认不执行，总统明确要求才触发。
文件操作纪律
大文件读取（>500 行）禁止 Read 全文，先 grep -n 定位再 Read offset/limit 窗口读取。不在输出中打印密钥、Token 或敏感凭证。.env 类绝不入库。
AI 误判自纠
AI 误判必须自我纠错并记录到回复尾部【AI误判清单】（误判/实际/教训三列）。表达规范遵循 ASD-STE100（短句/一句一事/少抽象词/术语首现即释）+ ISO 24495-1 Plain Language。
产出仪式
重申严丝合缝 → 排查 1-3 轮报自洽 → 按推荐拍板 → 执行 → 成品放 text 代码块交付。需求不清晰先提问确认，不自行推测意图。
单测哲学
禁止先写代码后补单测。孤立测试时先穷举失败方式再编码。强烈优先端到端测试验证复杂功能。测试结束须产出可验证可重复的工件。
知识库架构 12 个主题目录 · 同一主题一处写全
单元结构 layer/server · 11 件 · 一条数据流
AI 体系 4 件 · 点击切换
Agent 工程四件全景——零信任平台架构、记忆系统、类人脑记忆、jev 流程。
怎么操作 原理 · 流水线 · 闭环
意图 → 事实源
任何任务先落一条「唯一事实源」——一个文件、一条命令、一个日志锚点。事实源之外的信息只作参考，不作依据；来源冲突时回报冲突点与影响，不自行裁决。
计划 → 逐项落地
多步骤任务先拆成细粒度子任务并声明顺序，每项完成后单独断言，再进入下一项——避免串行改动互相掩盖问题。
执行 → 六查自检
改动完成不等于交付完成。逐项过：依据已锁定 / 改动未越界 / 无过程噪音 / 内容可直接使用 / 文档终态 / 旧设计处置已闭环。
反哺 → 知识闭环
代码变更涉及 API 字段、页面交互或数据结构时，同步更新对应项目文档——文档是下一轮的输入，不是事后补的说明。改旧文档优先，不另起新文件重写同一主题。
部署 → 双护栏
发版前备份锚点 + 可回滚声明先行；服务器端走统一脚本（pull→构建→备份→重启→健康轮询），不手工替换产物，部署后立即跑只读全链路验证。