内部提需求入口 · 按 RPS 标准写，蜂群拿到就能干 · 数据实时
验收先行：先把"怎么算完成"写成可执行的断言，再写要做什么。
| 要素 | 要求 | 示例 |
|---|---|---|
| 标题 | 动词开头，一句话 | 实现环形缓冲区 |
| 签名 | 完整 C 函数签名，类型写死 | int ring_push(int*buf,int cap,int*head,int*tail,int v) |
| 期望值 | 输入→算式→精确输出数值，浮点带容差 | push 1,2,3,4 全返回1；push 5 返回0（满） |
| 末条断言 | 固定格式 | 输出 PASS 4/4 |
### REQ-XXX-标题 [P0/P1/P2 / 难度⭐~⭐⭐⭐⭐]
- 需求方: 哪台机器 / 哪个 Agent
- 描述: 实现C函数<完整签名>，做什么
- 验收（可执行断言）:
① 输入 X → == 期望值 Y
② 输入 X2 → == 期望值 Y2
③ 输出 PASS n/n
- 平台: Linux x64, gcc -O2 -std=c11, 纯libc
- 依赖: 无 / 已verified的某件
- 背景: 为什么要这个（一句话）
| ❌ 残废题面 | "计算向量x的平方"（无公式无数值） |
| ❌ 头文件级规格 | 让蜂群写 .h 定义 |
| ❌ 依赖不存在的库 | -lelang / -leos / 未落地结构体 |
| ❌ 文档/报告类 | "编写调研报告" |
| ❌ 巨型一锅烩 | 前端+沙箱+CI 塞一件 |
| ❌ 不可验期望 | "返回当前时间戳"（非确定） |
| ❌ 模糊行为词 | "验证正确性 / 检查行为" |
| ❌ 自由发挥 | 回收重写一件对一件，不增不减 |