踩过 4 次 AI 代码的坑,团队把交付链路重排了一遍:事故追溯 3 天 → 40 分钟|附 5 段可复制源码

feat(coupon): recalculate stackable discount ceilingWhy: 大促券叠加时，优惠金额可能超过券面总额上限What: 引入 DiscountCeilingGuard，在优惠中心收口所有叠加计算AI-Generated: trueAI-Tool: claude-codeAI-Model: claude-sonnet-4.6AI-Prompt-Hash: 7f3a91c4Context-Files: src/coupon/stack.ts,docs/promo/rules.mdRisk-Level: highReviewed-By: @li-zhangRefs: PROMO-2291

# tools/stamp_commit.py —— Agent会话元数据自动生成提交trailerimport json, sys, hashlib, pathlibSESSION = pathlib.Path(".ai/last-session.json")REQUIRED = ("tool", "model", "prompt")def main(msg_file: str) -> int:    meta = json.loads(SESSION.read_text("utf-8")) if SESSION.exists() else {}    missing = [k for k in REQUIRED if not meta.get(k)]    if missing:        print(f"::error::AI 提交缺少元数据字段: {missing}")        return 1    p_hash = hashlib.sha1(meta["prompt"].encode()).hexdigest()[:8]    trailer = "\n".join([        "AI-Generated: true",        f"AI-Tool: {meta['tool']}",        f"AI-Model: {meta['model']}",        f"AI-Prompt-Hash: {p_hash}",        f"Context-Files: {','.join(meta.get('context', []))}",        f"Risk-Level: {meta.get('risk', 'medium')}",    ])    p = pathlib.Path(msg_file)    p.write_text(p.read_text("utf-8").rstrip() + "\n\n" + trailer + "\n",                 encoding="utf-8")    return 0if __name__ == "__main__":    sys.exit(main(sys.argv[-1]))

# .gitlab-ci.yml（节选）stages: [lint, test, ai-review, deploy]ai-review-gate:  stage: ai-review  rules:    - if: '$CI_COMMIT_MESSAGE =~ /AI-Generated:\s*true/'  script:    - python tools/stamp_verify.py       # 校验溯源元数据完整性    - complexity-check --max 8 src/      # AI代码收紧复杂度阈值    - coverage-delta --min 8             # 强制单测覆盖率增量    - security-scan --level high    - clone-detect --across-modules      # 检测跨模块复制粘贴重构  allow_failure: false  artifacts:    when: always    paths: [ai-review-report.html]

# AGENTS.md — AI编码智能体硬约束## 你必须先读- docs/promo/rules.md    优惠结算业务规则- docs/arch/decisions/   ADR架构决策记录## 你不能做- 不得修改 src/settle/**（结算域仅允许人工修改）- 新增第三方依赖必须在PR给出方案对比- 禁止为通过测试而直接修改单元测试## 你必须做- 金额统一使用Money类型，禁止float- 改动必须满足coverage‑delta >=8- 提交trailer由脚本自动生成，禁止手写

# review-policy.yaml 风险分级评审策略tiers:  high:    match: [支付, 结算, 优惠计算, 权限, 数据迁移]    reviewers: 2    require: ["coverage-delta>=8", "security-scan=high", "manual-signoff"]    sla_hours: 4  medium:    match: [核心域服务, 对外接口]    reviewers: 1    require: ["coverage-delta>=5", "security-scan=medium"]    sla_hours: 12  low:    match: [文档, 样式, 测试用例, 内部工具]    reviewers: 1    require: ["lint"]    sla_hours: 24limits:  max_open_prs_per_dev: 3  max_pr_loc: 400       # PR超过400行强制拆分  wip_limit_per_team: