12 · 清单附录(可直接用)

把系列里的原则收成 可勾选清单
建议:复制到团队 wiki,按仓库改一版「本地化」;不要追求一次完美。


A. 个人任务启动(每次 2–5 分钟)

  • 目标:用户/系统可见结果是什么?
  • 非目标:这次明确不做的?
  • 验收:测试 / 手动路径 / 指标,怎样算完?
  • 红线:不能改的模块、不能碰的数据、不能执行的操作?
  • 入口:关键文件、日志、issue、设计链接已备好?
  • 已要求 AI 先复述理解,并纠正过一次?
  • 计划是否先于大范围改代码?

口令: 说不清就开干 = 为返工预付款。


B. 会话卫生

  • 一个主目标,不把无关重构塞进同一会话
  • 出现目标漂移 / 反复自我矛盾 → 开新会话
  • 长任务有外部记忆(issue、计划文件、PR 描述草稿)
  • 敏感数据未粘贴进提示(密钥、客户 PII、未授权日志)
  • 破坏性命令未「为了省事」全部 allow

C. 实现中(小步闭环)

  • 切片足够小,能在短反馈环内验证
  • 每步有自动检查(test / typecheck / lint)或明确手动点
  • 新依赖、配置、权限变更被单独意识到
  • 没有「为了让测试绿」而削弱断言
  • 不确定的业务规则:已停手提问,而非猜测

D. 合并前自检(作者)

行为

  • 主路径我自己走过(不只是看测试输出)
  • 至少一个失败/边界路径想过或测过
  • 与需求/非目标对照,无范围偷跑

风险

  • 权限、鉴权、多租户:未放松
  • 钱、删除、不可逆迁移:有双检或加强验证
  • 兼容性:旧客户端/旧数据是否仍可用
  • 密钥与密钥材料:未入库、未进日志

可维护

  • 是否引入第二套并行抽象?(尽量否)
  • 命名与错误处理是否跟随邻接代码?
  • 关键注释/告警/回滚路径是否被误删?

协作

  • PR 描述含:意图、验证证据、风险、AI 参与程度
  • Diff 过大时已拆分或先贴设计说明
  • 我能向同事讲清「为什么这样实现」

E. 评审者清单(审 AI/人混合 diff)

优先看:

  • 行为是否匹配意图与非目标
  • 错误路径、超时、重试、空值
  • 安全:注入、权限提升、SSRF、危险反序列化等(按栈)
  • 数据一致性与并发假设
  • 测试是否在测对的东西(会不会假绿)
  • 依赖与 CI/CD 变更的爆炸半径
  • 是否可用更小改动达到目标

可以降权:

  • 纯格式(交给工具)
  • 已被强测试锁死且行为正确的样板细节

禁止: 仅凭「看起来专业」或模型自评而 LGTM。


F. 仓库级最低配置(团队)

  • 给人和模型看的说明(README / CLAUDE.md / AGENTS.md
  • 如何跑测试、lint、本地服务
  • 架构边界与「别动」名单
  • 代码风格与错误处理约定(或指向现有文档)
  • 已知坑与事故摘要(越短越好)
  • 密钥扫描 / 预提交或 CI 门禁
  • PR 模板含验证与风险字段

G. 组织红线(一页纸可贴墙)

数据

  • 哪些数据禁止进第三方模型
  • 生产数据脱敏规则
  • 日志外传策略

权限

  • Agent 默认权限(建议:探索只读,写入分域)
  • 推远程 / 改生产 / 删数据:必须人类
  • 依赖新增与 CI 权限变更:单独审

责任

  • 合并者 = 行为责任人
  • 生产变更有人类 approver
  • 事故复盘包含:提示/工具/门禁,不只骂个人

H. Tech Lead 30 天落地(精简版)

第 1 周

  • 选定 1–2 个试点仓库
  • 写完仓库说明 + 数据/权限红线一页纸
  • 改 PR 模板

第 2 周

  • 一次「真实 backlog + AI + 对抗评审」工作坊
  • 收集 3 个成功、3 个翻车 → FAQ
  • 定一个基线指标(如 lead time 或逃逸缺陷)

第 3 周

  • 推广提示模板(修 bug / 小功能 / 重构)
  • 检查高风险目录是否过宽权限
  • 与安全/法务对齐模型供应商策略(若适用)

第 4 周

  • 回顾指标与主观负荷(是否更累、是否更敢改核心)
  • 决定:扩大试点 / 补门禁 / 暂缓某类任务
  • 把可复用约束合并进平台或模板仓

I. 风险 × 用法速查

等级例子清单要点
内部工具、文档、脚本A+C,快速迭代
常规业务功能A+C+D+E
支付、权限、加密、删数人设计 + 强化验证 + 双人
极高生产应急、不可逆迁移AI 只读分析,执行人工

J. 周度个人复盘(15 分钟)

  • 本周哪个任务 AI 杠杆最大?为何?
  • 哪次幻觉/返工本可避免?缺了什么约束?
  • 有没有任何「我合了但讲不清」的 diff?(还债)
  • 一条可写入仓库/团队文档的新规则?
  • 是否有核心技能在萎缩?(安排一次无 AI 小练习)

K. 反模式速查(看见就停)

  • 「帮我优化一下」无验收
  • 无测试连续「继续完善」
  • 超大 AI diff 要求当日报合
  • 全 allow 权限图省事
  • 用生成行数汇报绩效
  • 事故时让 agent 直接改生产
  • 禁止讨论失败,导致地下使用
  • 把模型厂商当唯一灵魂绑定

L. 与本系列的索引

清单展开阅读
A–C 个人启动与闭环03 · 实践 10 · 场景
D–E 合并与评审03 04 · 风险
F–H 团队与组织06 · 组织
I 风险分级04
J–K 复盘与反模式05 · 角色 11 · 误区
立场总览08 · 总论

使用建议

  1. 先跑 A+D+E 两周,再谈平台化
  2. 清单是门禁提醒,不是绩效考核 KPI 本身
  3. 每季度删掉过时项、补进新翻车
  4. 新成员入职第一天:过一遍 G(红线)与 F(仓库)

返回目录:README