| name | code_impl |
| description | RD 按 tech_design.md 在沙盒里实现代码 + 单测 + 跑 pytest 通过。当 RD 收到 type=task_assign 且 subject 含'实现代码/code'的邮件时**一定**加载本 skill。五层分目录写代码 + 单测 ≥80% 覆盖 + 最多 3 次失败重试 → task_done 回 Manager。所有'开始写 feature code'的时刻走此 skill。必须 sandbox_execute_bash。 |
| type | task |
code_impl — 代码实现 + 单测
⚠️ 执行方式
必须 sandbox_execute_bash。宿主机 Python Tool (write_shared) 虽然能写文件，但跑测试需要沙盒环境（pip install + pytest）。两种混用：
- 用
sandbox_execute_bash cat > EOF 写代码文件（因为要立刻跑 pytest）
- 用宿主机 Tool
send_mail 发 task_done（因为 mailbox 在宿主机 filesystem）
🚨 Critical Rules
- 禁 uvicorn 长进程：测试一律
httpx.Client(app=app)；打开进程=失败。
- 覆盖率 < 70% 不交付：必须补测试或跟 Manager 说明放宽（revise）。
- pytest 失败 ≤ 3 次重试：每次失败分析 stderr，不要盲猜。
- requirements.txt 必写：包含所有 import 依赖；不许"假定全局安装"。
步骤
Step 1 — 读技术方案
sandbox_execute_bash cmd="cat /workspace/shared/projects/{pid}/tech/tech_design.md"
Step 2 — 建五层目录
mkdir -p /workspace/shared/projects/{pid}/code/{routers,services,models,schemas,tests}
Step 3 — 按 tech_design 写代码
对每个模块：
cat > /workspace/shared/projects/{pid}/code/models/{module}.py <<'EOF'
...
EOF
必需文件：
code/main.py（app + router 挂载）code/database.py（engine + SessionLocal + get_db）code/models/*.py（ORM）code/schemas/*.py（Pydantic）code/routers/*.py（薄路由层）code/services/*.py（业务）code/tests/test_*.py（每 router 一份）code/requirements.txt
Step 4 — 跑测试
cd /workspace/shared/projects/{pid}/code && \
pip install -r requirements.txt -q && \
python -m pytest -x --cov=. --cov-report=term 2>&1 | tail -60
Step 5 — 失败修复（≤ 3 轮）
- 读 stderr 最后 30 行
- 定位是哪个测试哪个断言失败
- 改代码（而非改测试，除非测试本身写错）
- 重跑 Step 4
Step 6 — 记 metrics + 发 task_done
Python Tool：
send_mail(
to="manager", type="task_done",
subject="代码实现完成",
content={
"artifacts": ["code/main.py", "code/tests/...", "code/requirements.txt"],
"metrics": {"pytest_final_status": "pass", "pytest_attempts": N, "coverage": 0.XX, "loc": ...},
"self_score": 0.XX, "breakdown": {...},
"rationale": "..."
},
project_id=pid,
)
mark_done(pid, <task_assign_msg_id>)
输出
{
"status": "success",
"artifacts": [{"path": "code/main.py", "kind": "code"}, ...],
"metrics": {"pytest_final_status": "pass", "pytest_attempts": 1, "coverage": 0.87, "loc_total": 420, "loc_test": 180},
"self_score": 0.88,
"breakdown": {"completeness": 1.0, "self_review": 0.95, "hard_constraints"
