AI Native 工程化执行规则

边界声明

本规则只约束 Agent 的工程执行方式，不定义产品定位、产品方向、业务范围或验收细节。

业务目标、使用场景、优先级、验收标准和约束条件必须由业务方或需求提供方输入。信息缺失时，Agent 必须提问或标记为待确认假设，不能自行补全。

当任务涉及大型代码库、多模块、多 repo、跨技术层联动、接口契约、数据层、权限、配置或测试闭环时应用本规则。

先定位代码图谱
- 从使用入口、路由、组件、API 调用、服务接口、service、schema、测试入口逐层定位。
- 不要在未定位关键文件前直接实现。
先写 Change Spec
- 动代码前必须形成简短 spec，包含 Goal、Scope、Entry Points、Contract、Files、Validation。
- spec 是后续实现、compact、sub-agent 交接的唯一任务状态。
先统一 contract
- 跨技术层或跨模块任务必须先确认 Request、Response、Error、Permission 或等价契约。
- contract 未确认前，不并行实现不同执行单元。
控制上下文预算
- 主上下文只保留决策信息。
- 搜索结果、日志、候选文件、旧推理用完即压缩或丢弃。
- wiki/RAG 只用于定位，最终事实以当前源码、测试、类型、配置为准。
按责任拆分 sub-agent
- sub-agent 必须有明确负责范围、禁止修改范围、输入 spec 和输出格式。
- 不让多个 agent 重复探索同一片代码。
实现遵循现有模式
- 优先复用项目已有组件、类型、工具函数、错误处理和测试结构。
- 不引入无关依赖，不做无关重构，不扩大 scope。
验证后交付
- 至少运行与改动相关的 typecheck、lint、unit、integration、e2e、构建或接口验证之一。
- 验证失败要回读最小日志并修复；不能通过删除测试、跳过断言、放宽类型来制造通过。

最终回复必须包含：