Release AirCoding-Alpha-0.1.0
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
53
CLAUDE.md
Normal file
53
CLAUDE.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# Aircoding — 约束铁律
|
||||
|
||||
## 1. 调度器约束
|
||||
|
||||
调度器(Scheduler)禁止以下行为:
|
||||
|
||||
- **禁止降级兜底**:不得以「先这样实现」「先跑通再说」「以后再改」「以后再补」「先回退」「先这样」等理由,使用简化逻辑、mock 实现、硬编码路径、或任何偏离设计方案的替代品。
|
||||
- **必须完全遵循设计方案**:调度器的任务拆分、依赖图、执行序列、重试策略、错误传播等全部行为必须严格按照设计文档实现。设计方案未覆盖的场景,必须先更新设计方案再实现,不得在代码中自行裁决。
|
||||
|
||||
## 2. 执行器约束
|
||||
|
||||
执行器(Executor)禁止以下行为:
|
||||
|
||||
- **禁止降级兜底**:不得以「先这样跑通」「以后优化」「暂时绕过」「先硬编码」等理由,跳过或简化任何设计规定的执行步骤、工具调用链路、权限检查、日志落库、事件上报。
|
||||
- **必须完全遵循设计方案**:执行器的工具链、Agent Loop、权限门控、结果验证等全部行为必须严格按照设计文档实现。任何偏离 = 未完成。
|
||||
|
||||
## 3. 审查器约束
|
||||
|
||||
审查器(Reviewer)是**强制调用**的关卡,不可跳过、不可默认通过、不可降级为静默占位。
|
||||
|
||||
### 3.1 禁止的判定依据
|
||||
|
||||
以下理由**不得**作为通过审查的依据:
|
||||
|
||||
- 「测试 pass」「测试全绿」
|
||||
- 「实现存在」「函数存在」「文件存在」
|
||||
- 「typecheck 通过」「build 通过」「lint 通过」
|
||||
- 「看起来正确」「逻辑应该是对的」
|
||||
|
||||
### 3.2 强制审查流程
|
||||
|
||||
审查器必须按以下三层逐项执行,全部通过才能放行:
|
||||
|
||||
1. **Code-to-Design 逐行对照**
|
||||
- 将代码实现逐行/逐函数与设计方案和用户需求对照
|
||||
- 确认每个设计要点在代码中有对应的实现
|
||||
- 确认代码中没有超出设计范围的自行发挥
|
||||
- 确认没有以「先这样」为名的降级实现
|
||||
|
||||
2. **静态审查**
|
||||
- 安全性:注入、越权、敏感数据泄露、输入校验
|
||||
- 正确性:边界条件、空值处理、并发安全、资源释放
|
||||
- 合规性:架构铁律(仅调度层可自研,其他用 OpenCode 现有实现)
|
||||
|
||||
3. **测试通过**
|
||||
- 仅在上述两关通过后,测试通过才有意义
|
||||
- 测试本身必须覆盖用户需求的核心路径
|
||||
|
||||
### 3.3 审查结果
|
||||
|
||||
- 审查未通过时,必须列出具体的不合规项(文件:行号、设计要点、偏差描述)
|
||||
- 不合规项修复后重新提交审查,直到全部通过
|
||||
- 审查报告作为任务完成的前置证据
|
||||
Reference in New Issue
Block a user