每条:❌ 反模式 → 教训与纠正。带「源案例」的来自项目 A 的实战。 追加机制:新项目撞出的教训先记入项目实例,由 Owner 触发回流本母本。
- ❌ 把任务卡写成实现说明书——实现步骤、内部函数拆分、数据结构、文件白名单全写死,等于把出卡人的盲区原样复制进实现,也让实现方失去提出更好做法的余地;卡面越长,出卡侧缺陷的面越大。卡面只写目标、完成判据、本卡特有约束、已知未知,经验放「上下文指针」并注明是参考不是指令(architect.md §1.2)。放权的前提是红区清楚,不是卡面写满。
- ❌ 让一个较弱的模型夹在设计和实现之间写卡——想省下最强模型的开销,于是让"PM"根据设计文档拆卡、写判据。它成了有损中继:下面这一节记录的缺陷连最强的模型都会犯,转述一道只会更多,而且实现方再强也只能照着被转述坏的卡面做。该从 Architect 身上卸下来的是控制链路(派卡、状态、挂账、催办),不是内容链路;卡面永远出自 Architect,Conductor 不碰内容(protocol §1)。
- ❌ 把推断当事实写进卡面——出卡时没核实的数据源、接口、根因,写得和核实过的一样笃定,实现方会照着做出一个"在错误假设下恰好变绿"的结果。没核实的进「已知未知」,交实现方开工时确认(architect.md §1.3 第 2 条)。
- ❌ 一张任务卡塞多个目标——拆!一卡一个可独立验收的目标;相互依赖的用批量模式(统一分支、按卡独立 commit),不是塞进一张卡。
- ❌ 验收标准写"功能正常"——不可检查 = 没写。每条完成判据必须可机器或可人工明确判定。
- ❌ 让 Implementer 自行设计跨模块接口——跨模块、会被别的卡消费的契约必须 Architect 先定,写在设计文档里。实现侧可以对本卡新引入、尚无人消费的接口形状发提案并继续(黄区),对已被消费的契约只有执行权和上报权(红区)。
- ❌ 同一任务卡存在两个措辞版本(仓库版 vs 派活提示词复制版)——单一事实源:提示词只指向仓库卡面路径。(源案例:项目 A T0.1)
- ❌ 修订卡面任一区块后不做自洽检查——裁决改了契约却没同步放开范围,制造新矛盾。任何裁决/修订落卡后,目标 ⇄ 判据 ⇄ 约束 通读一遍再放行复工。(源案例:项目 A T0.2)
- ❌ 契约中使用不限定作用域的全称量词("全部/一切/任何…取最新")——量词把仓库既有基线也扫进去。必须显式限定("本卡新增的…");既有基线默认继承,升级走独立任务。(源案例:项目 A T0.2)
- ❌ 卡面引用不存在的数据源——写"按文件顺序展示"却没核实顺序信息在数据链路(源文件 → 构建 → 运行时)中真实存在;构建工具早已把顺序规范化掉了。每个「顺序/坐标/默认值」引用都要先沿链路确认数据源。(源案例:项目 A T2.2)
- ❌ 拿"某测试变绿"当"生产代码修好"的证据,而那条测试根本不走生产路径——
#[cfg(test)]分叉是最常见的形态:项目 C 的工作区清理缺陷里,判题收尾在测试下调用cleanup_with_diagnostic()、只有#[cfg(not(test))]才drop(workspace),而那个诊断函数自身带#[cfg(test)],前一阶段做的重试逻辑整个长在测试专用路径上,生产Drop至今还是一行静默删除。于是卡面门槛「Windows 上该测试通过」可以在生产代码一行未改的情况下达成。出卡时逐条问「这条绿了能证明那段生产代码改了吗」,脱钩就把门槛改成直测生产入口 + 编译期证明两路共用同一函数/常量,并明写「仅有某测试变绿不构成达标」。(源案例:项目 C T3.10,Reviewer 预审查出) - ❌ 防假绿门槛只用规范输入——正确实现与错误实现在规范输入下往往同样通过,门槛因此没有区分力。项目 C 的同一张卡要求「落盘值必须来自校验后的归一结果,不能直接回写原始输入」,但门槛只给了规范输入
python/python.exe——直接回写原始字符串的错误实现在该输入下三项断言全过。补一个合法但非规范的输入(python//python.exe)才能区分。构造前先核实它真能走到断言处:能过前置校验、不被上游规范化吞掉。(源案例:项目 C T3.10,Reviewer 预审查出) - ❌ 要求一个当前架构里没有消费方的接口——项目 C 的卡面写「上界耗尽后错误码进日志」,而该 crate 没有任何日志 crate,且 Windows release 下
windows_subsystem = "windows"使 stderr 无处可去。这类要求没有可验收形态,实现方只能自行发明接口,而任意打印都可能被误收为达标。出卡前确认要求的出口真实存在且可消费;不存在就明确拆到后续卡并从本卡删除,不要留一条"精神上正确"的 DoD。(源案例:项目 C T3.10,Reviewer 预审查出) - ❌ 用全局
git grep当机器门槛——"grep 证明不存在第三处硬编码"听着可验证,实测该文件有 11 处合法命中(测试数据、旧记录断言),全局结果不可能为零,人工解释一串命中不构成门槛。判据要收窄到具名函数体或具名符号,让"通过"是机械可判的。(源案例:项目 C T3.10,Reviewer 预审查出) - ❌ 改完文档不跑仓库自身的格式检查就提交——出卡方改的文档通常不在实现方允许范围内,而"格式全绿"通常是实现方 DoD 的一条。项目 C 出卡方改状态文档时把表格某列改长、没跑 Prettier,实现方开工即撞
format:check红灯:文件不在实现方范围、工作区对它零差异、两项冻结契约无法同时满足,只能 L1 停工等裁决。实现方连修都不能修。提交前跑一遍格式检查,成本几秒。(源案例:项目 C T3.10 派卡当天) - ❌ 内容生产任务不给"知识边界闭包"清单——不列出前置概念闭包,产出必然超纲。
- ❌ 卡面点名技术栈却不枚举依赖闭包——companion 包(types、插件、CLI)与 peerDependencies 没核查,实现期连环 L1。(源案例:项目 A T0.2 两次)
- ❌ "发现更好的契约所以直接改了"——最严重违规。注意区分:更好的实现方式在绿区内直接用,是被鼓励的;改的若是目标、DoD、公共接口,或越过红区,发现的价值在进入裁决流程,不在绕过它。
- ❌ 把绿区当成"什么都要自己扛"——明明超出了纯实现决策,还硬着头皮自己定、也不说。拿不准时问回退成本:封在本卡内就发提案后继续,会外溢就停(protocol §6.1)。
- ❌ 因为拿不准就停工——上一条的反面。把所有不确定都升成 L1-停,等于把协议退回一律停工;源项目五次停工的裁决与实现侧首选方案 5/5 一致,等待是纯损耗。提案并继续才是默认动作(保守档除外,见 profiles/guarded.md)。
- ❌ 提案发出去就当它生效了——提案是"先做,保留被否决的可能",不是默许。到交付还没答复的提案必须在交付报告单列并标「需 Architect 过目」,该卡合入前等答复。相关改动单独成 commit,否决时才回退得动。
- ❌ 「需 Architect 过目」该标不标,或者什么都标——不标,触及契约的决策就绕过了唯一有权判断的人;全标,就把按需唤起的 Architect 拉回每张卡。只标三类:未答复提案、触及契约或设计意图的决策、会影响后续卡的发现(implementer.md §5)。
- ❌ 把不同性质的流程问题混为一类——已授权依赖引发的 lockfile 变更属于绿区的必需配套,可继续;但 PR 体量、任务拆分策略不是实现决策,需预拆或明确裁决。红区/绿区逐条对定义,不凭感觉套用。(源案例:项目 A T0.4)
- ❌ 自检写"应该没问题"——每条判据要写明验证方法;没验过的如实标注存疑。
- ❌ 存疑点漏报——宁可多报。review 撞出来的隐瞒成本远高于自报。
- ❌ 未核数据链路就把疑似缺陷定性为实现侧责任——先查是不是出卡侧引用了不存在的数据源,再定责。冤枉实现者一次,信任成本抵十张卡。(源案例:项目 A T2.2 概念顺序:review 初判"实现丢了作者顺序",核查后确认构建期顺序早已不存在,是出卡缺陷 + 内容模型缺口)
- ❌ 轻信交付报告的"全绿"不复跑——本地门禁全量复跑 + 生成物重生成 hash 比对;CI 核实到同一 HEAD。
- ❌ 实施发现无回应地合并——L2/L3 每条都要有归宿(采纳→文档/任务/挂账;否决→给理由),挂账必须落到 backlog 可见位置。
- ❌ L1 裁决落地不验忠实性——裁决过的事项,验收时逐项核对是否按裁决原文实现,不默认"裁决了就等于做对了"。
源案例:项目 B 的 B-000(一个只有 Owner 和两个 agent 会改的本地文档检查脚本)。它走了 7 轮双 Architect 交叉 review + 2 轮实现打回,实际体量做到预算的 2.3 倍。以下四条都出自这一张卡的复盘。
- ❌ 按"这段代码重不重要"决定验收强度——正确判据是"它面对谁"。对上面那张卡,验收方构造了"有人在架构文档里插入一个编号相似的诱饵章节来骗过检查"这类反例;技术上全部成立,但没有人会攻击自己的架构文档。虚构一个不存在的对手,会让常规卡按对抗卡的成本交付。出卡时就回答"谁会攻击它",答不上来就是常规档(protocol §2.2)。
- ❌ 交叉 review 不设止损——这个环节没有自然终点:每一轮都能挑出东西,而挑出东西不等于值得挑。上述 7 轮里真正救命的是前 4 轮(假绿判据、规则在基线上必然假红、门禁自证循环),后 3 轮全是表述除虫,其成本超过了它们避免的返工。用 protocol §2.1 的一次给全 + 只打回有依据的 + 轮次封顶 + 越线信号收口;审方和被审方都有义务喊停。
- ❌ 只改被点名的那处,不扫全文——契约文档里一处语义变更平均牵动 2–3 处引用(正文、理由括号、验收样例、交叉引用节号)。只改被点名处,会让每一轮 review 都稳定产出下一轮的缺陷,轮次因此不收敛。architect.md §1.3 第 4 条的"卡面自洽"讲的是目标 ⇄ 判据 ⇄ 约束,这里补的是同一份文档内部:改完后按关键词全文搜一遍(数量词、被改动的术语、节号),确认没留下前后打架的旧措辞。
- ❌ 拿未经验证的一次性探针去打回实现——为了不轻信交付报告而临时写的验证脚本自身没被评审过,既会假绿也会假红。上述案例中同一个人的临时脚本连续三次假红:取表格单元格没剥反引号、按
§5.3匹配而实际标题是### 5.3、按group读字段而实际字段名是check。每一次都差点变成一条错误的打回。下结论前先用已知结果的样本验证探针本身(干净输入 → 零问题;注入已知缺陷 → 能报出)。
- ❌ L1 裁决只修上报的那张卡——同因扫描:一次裁决扫全批,同一病因不允许卡第二轮。(源案例:项目 A E1 批)
- ❌ 把"必然配套"决策也留在 L1——五次停工裁决与实现侧首选 5/5 一致 = 裁决零信息增量,白白付出停工等待。低风险必然配套下放绿区,配披露审计。(源案例:项目 A E1 批复盘,催生绿区制度;后放开为"红区以外都是绿区",现又加黄区,把需要第二双眼睛但等不起的事改成提案并继续)
- ❌ Conductor 当中继或顺手裁决——用自己的话转述卡面和裁决,或者看到 L1、退回争议就给了结论。前者制造第二版本,后者的结论没有效力却会让当事方以为事情定了。Conductor 的动作只有"指给有权回答的人,附原文路径"(conductor.md §0)。
- ❌ 卡级门禁掺判断——Conductor 在门禁退回项里写"这里实现得不好""细化不够严""建议改成…",或者因为初审意见没被采纳就卡着不合。门禁结论的全部价值在于便宜、每张卡都做、结论不靠口味;掺进判断,退回就失去了依据。门禁结论只引 protocol §2.3 的封闭清单与命令输出;看法写进另起一节的初审意见(初审档),机械判不了的指给 Architect。
- ❌ 把有判断力的 Conductor 锁成跑脚本的机器——早期为了防弱模型越权,Conductor 被规定"不写建议、不评价实现"。换上能读懂代码的模型后,这条锁让逐卡读代码的空档一直空着(Reviewer 不做 code review,Architect 只在收官看结构)。按模型登记档位:能读懂代码的开初审档,放开"说",不放开"判"(protocol §1.3)。
- ❌ Conductor 只转自己的理解,不带 Owner 原话——Owner 的意图经过一次压缩才到 Architect,被丢掉的限定词谁也看不到;Architect 按压缩后的意图出一批卡,返工从出卡就开始了。派给 Architect 的内容类事项一律附原话,理解另起一段并标明(conductor.md §1.1)。
- ❌ 说人话时换了确定程度——向 Owner 汇报时把"推断"说成"确认"、"本地通过"说成"通过"、"修了一半"说成"在修"。说得顺不等于说得对:可以换说法,不可以换确定程度(conductor.md §1.3)。
- ❌ 初审意见泛滥——每张卡都凑满三条、把口味包装成改进、为了显得有用而挑刺。实现方处理每一条都要花上下文,噪音多了,真正的疑似缺陷也会被一并"不采纳"。没有值得说的就写"无";Conductor 每个里程碑统计采纳率,连续偏低就少提或降回基础档(conductor.md §4.5)。
- ❌ 初审意见被当成命令——Conductor 用"必须""需要修改"的口吻写,或者实现方把每条建议都当退回照做,卡的范围就悄悄膨胀。初审意见不阻塞、不扩大范围:卡面没要求的东西一律挂账,"现在改"每卡最多一次追加交付(implementer.md §6.1)。
- ❌ 空洞的肯定——"做得很好""辛苦了"不提供信息,还会稀释真正有用的肯定。肯定是校准信号,要具体到实现方能在后续卡里复用:哪一处、好在哪。说不出来就不写。反过来,退回也只写事实,不写"又没跑测试"这种带情绪的话——措辞严厉的退回容易让模型过度修改、畏手畏脚。
- ❌ 把门禁全绿当成验收过了——门禁复跑的是实现方自己写的检查,它证明"交付齐了、没越线、自测可复现",不证明"目标达成了"。里程碑验收必须按卡面目标独立实测;里程碑也因此要切小,别让未经实测的卡堆得太高。
- ❌ 集成人替实现方解合并冲突——解冲突是在改代码,而集成人没读过这张卡的实现。冲突一律退回实现方同步基线后重新交付。
- ❌ 一套规则管所有模型——为了压住较弱的模型把限制越加越多,强模型被同一套限制拖慢;或者反过来,按强模型放权之后换了个弱模型,没人收紧。规则按执行者档位取用,档位登记在部署配置里(protocol §1.3)。
- ❌ 形态 A 下不确认对方现场就 merge / 切分支——共享工作区里这类操作直接摧毁对方未提交工作。第一铁律。
- ❌ 信道里复述文档内容——信道只给路径与结论;复述制造第二版本,回到"两个措辞版本"老坑。
- ❌
git add用了 pathspec 就以为安全,git commit却不带——commit提交整个 index。形态 A 的 index 可能有他人的信道回执,普通提交会连带收入。提交前核对 cached diff 或显式限定路径;误提交后的处理先按 protocol §3.3 确认拓扑与本轮起点,托管任务不能套用回退重提。(源案例:一次出卡提交连带 733 行信道) - ❌ 靠锚点匹配或 git 视角决定消息写在哪——两种写法都会把消息插进文件中间:①"找某句话再在其后插入"的编辑方式,长文件里锚点必然歧义,而每条消息的结尾套话都长得差不多;②形态 A 下用 git 视角判断末尾——协议要求"自己的消息不 add",暂存版与 HEAD 版因此永远短于工作区文件,照它定位就会写到别人未暂存消息的前面。写入点只能是工作区文件的物理末尾;
git diff HEAD --只用于读增量,不用于定位。光靠禁令不够:§3.1 早就明令禁止模糊匹配写入,仍在同一项目里复发两次(#177、#223),第一次的补救是重发"EOF 权威副本",代价是留下一个重复编号——所以现在配的是写后自验三条断言(protocol §3.1),当场能发现,不依赖谁记得住。
- 为规范提交说明而 amend 宿主 checkpoint:SilverShield 的 SWO-152 从
1456e68b开始,随后 amend 为52102e91;两者父提交与 tree 相同,但起点不再是交付提交的祖先,Multica 因而拒绝记录。保留本轮起点及之前的提交,只为新提交执行署名规范,每轮 start/交付 check。(源案例:2026-09-09 核对保留 worktree 的 reflog) - 把本地 worktree 当 A 或 B:它不共享工作文件/index,也不需要 push 才能看到提交。按实际 common-dir 判断;C 提交独立消息文件并用 ID/ack 确认,不要等对方 add 本方消息,也不要并发争抢单文件的下一个编号。
- 为验收切换托管分支,或收口时清理平台 worktree:这会改变本轮身份或毁掉平台尚需记录的现场。评审固定交付 SHA,必要时用自己创建的临时 detached worktree;由登记的集成人串行集成,平台任务资源由平台回收。实际宿主回收效果须另做真实运行验证。
- ❌ 把该自己修的问题留给 Owner——因为"拿不准""改动有点大"就写进报告让 Owner 定。有客观依据(指得到目标、判据、契约,或可复现)且修法清楚的问题,Owner 的回答只会是"修啊",而 Owner 为此多付了一次阅读和一轮往返。检验:Owner 看到改完的结果会不会只说一句"本该如此"(protocol §6.2)。
- ❌ 把该 Owner 定的自己定了——界面、文案、默认行为、范围取舍,因为"我觉得这样更好"就改了。这类事没有客观对错,两个合理的 Owner 会选得不一样。正确做法是按推荐方案做出来给 Owner 看,并写明改主意的回退成本,而不是替 Owner 拍板,也不是空着手去问。
- ❌ 给 Owner 交开放式问题——"这里怎么处理比较好?"把分析成本转嫁给了最不了解细节的人。每个裁决项写成选择题:现状、方案、各自代价、推荐。
- ❌ 等 Owner 裁决期间停工——绝大多数留给 Owner 的事都有一个容易回退的先行方案。按它先做,在清单里注明;只有先行方案本身不可逆才真的等。
- ❌ 收官自迭代不设止损——和交叉 review 是同一种失效:每评一轮都能再找出点什么。最多两轮,复评只看补卡涉及面;剩下的如实写进「遗留缺陷」。报告可以带着缺陷交,不可以带着没说的缺陷交。
- ❌ 单卡不审了,收官评估也只看各卡报告——逐卡审核取消之后,架构漂移唯一的检查点就是收官评估。它必须在合并后的主干上看实际结构、实际跑一遍,否则"按需唤起"就成了"没人看"。
- ❌ 报告写成流程复述——"T3.1 派卡,T3.1 交付,T3.1 验收通过……"Owner 要的是做成了什么、效果怎样、还差什么、自己要决定什么。
流程变更说明:本框架两次收窄了开发期的把关,代价都要认。
- 取消开发期预审:早期 Reviewer 参与卡面预审与交付初审,后改为只守合入口。预审确有实战收益——项目 C 首张高风险卡(T3.10)的预审一轮提出 5 项硬意见,核实后全部成立,都是 Architect 出卡时漏的;这些已并入 architect.md §1.3 出卡自查。代价:异源的开工前第二双眼睛没有了,出卡侧缺陷发现得更晚。
- 取消 Architect 逐卡审核:Architect 改为按需唤起,架构把关集中到里程碑收官评估。代价:单卡层面没有人读代码找隐患,结构性问题要到里程碑末才暴露,返工面更大。Conductor 开初审档时,逐卡读代码的空档部分补上(只提意见,不阻塞)。尚未经实战校准。
- 常规卡的实测从逐卡挪到里程碑末:每张卡只过 Conductor 的机械门禁(复跑的是实现方自己写的检查)就集成,Reviewer 在卡全部集成后才把整体跑起来。代价:"判据细化得太松""单看没问题、合起来不能用"要到里程碑验收才暴露,而且后面的卡可能已经建在有问题的卡上。对抗档与取证档不走这条捷径。尚未经实战校准。
回退办法:某项目反复出现"实现完才发现卡面错了",对高风险卡恢复预审;反复出现"收官时才发现结构跑偏"或"里程碑验收问题成堆",先把里程碑切小;还不行就把关键卡标为逐卡验收(与对抗档同样处理),或把相关 Implementer 登记为保守档(恢复逐卡审核,profiles/guarded.md §3)。
下列条目中,标「旧流程」的来自开发期评审阶段,保留作历史教训;其余适用当前流程。
- ❌ 三方仍拿
git add当已读回执——A 的 staging 是单一状态,表达不了谁读了:只有主收件人 add,抄送方用git diff HEAD --,真正水位线写进消息。B/C 连 index 都不共享,必须使用显式确认,C 按消息 ID ack(protocol §3)。 - ❌ Reviewer 用退回实质改契约——"卡面这样不好,改成 Y" 越过了 Architect 的契约权,Implementer 收到两个头的指令。当前流程里逐卡验收的退回直达 Implementer,所以这条防线全靠退回纪律:每条退回只能引卡面已有的依据并附复现,卡面本身的问题标明后交 Architect,不借退回提新要求(protocol §6.3)。Implementer 觉得某条退回是在改契约,直接提异议交 Architect 定性。
- ❌ 给每张卡都上满验收清单——验收强度必须随卡面强度档走(protocol §2.2),常规档不做恶意输入矩阵。这和「交叉 review 不设止损」是同一种失效,只是搬到了验收环节。
- ❌ 验收时做 code review——Reviewer 逐行挑写法、命名、结构,挤掉了真正属于它的工作:把交付跑起来。读代码只为确认改动面没越线;验收的时间花在门禁复跑、目标实测、主干回归冒烟上(reviewer.md §0)。
- ❌ 只看报告和门禁记录就合主干——常规卡在集成前没有任何独立实测,Reviewer 的里程碑验收是合入主干前唯一一次"真的跑起来"。看记录全绿就合是橡皮图章。
- ❌ 漏检与误退回不回流——没有这条证据链,三个月后没人说得清审核和验收到底拦下了什么,两个环节都会静默退化成橡皮图章。验收查出出卡时该想到的 → 记出卡漏检;合入后暴露验收该实测出来的 → 记验收漏检;退回被判不成立 → 记误退回。分别补进 architect.md §1.3 / reviewer.md §2。
- ❌ 裁决只回给 Implementer,不抄送 Reviewer(旧流程)——Reviewer 参与初审时,手里是旧卡面就会成批误打回已按裁决改对的地方。当前流程改为裁决直接落在卡面上,Reviewer 按交付消息给出的卡面 SHA 读最终卡面;裁决改了卡面却没落卡是同一个坑。