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 · 总论 |
使用建议
- 先跑 A+D+E 两周,再谈平台化
- 清单是门禁提醒,不是绩效考核 KPI 本身
- 每季度删掉过时项、补进新翻车
- 新成员入职第一天:过一遍 G(红线)与 F(仓库)
返回目录:README