探索一套让 AI Agent 在大型遗留项目中少写错业务逻辑的方法。
当前项目还不是工具实现阶段,而是在验证第一版 MVP:业务逻辑护栏。
业务逻辑护栏不替 Agent 写代码,而是在修改前后提供任务级约束:
- 修改前:提取关键业务规则、风险区域、阅读路径和禁止事项。
- 修改后:反查是否破坏旧规则、遗漏特殊分支或缺少必要验证。
第一优先级是减少业务逻辑错误,不是节省 token。
- AGENTS.md:给 agent 的工作规则和安全边界。
- docs/roadmap.md:当前路线图和阶段计划。
- docs/mvp.md:MVP 定义和成功标准。
- docs/evaluation.md:对照实验和评分方式。
- docs/project-background.md:项目背景、设计原则和候选形态。
- 选择一个真实遗留项目中的小任务。
- 记录实验案例和基线表现。
- 提取任务相关的业务规则卡。
- 生成给 coding agent 的任务护栏包。
- 让 agent 基于护栏完成修改。
- 用改后审查模板检查业务规则和工程产物。
- 记录对照结果,并反哺模板和评估标准。
- templates/experiment-case.md
- templates/business-rule-card.md
- templates/task-guardrail-pack.md
- templates/post-change-review.md
真实实验材料默认放在 docs/cases/,除 README.md 外不提交到 git。
可提交内容应优先是脱敏后的方法论总结、模板、路线图和开发日志。