# Exec

> 阶段④ 执行。主 agent 跟踪进度 + 并行派生子 agent 实现模块，含代码门禁与调试档位。

- Skill: `wang123582/exec` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wang123582/exec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wang123582/exec/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wang123582 (https://skillmd.com/u/wang123582)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/wang123582/exec

---


# ④ 执行

**验收**：`pytest` / `mypy` / `ruff check` 三项**实际跑过并贴出输出**，全绿。

## 主 + 子 agent 机制

1. **主会话 = 进度跟踪器**：读 `tasks/progress.md`，挑出未完成且**相互独立**的模块。
2. **并行派生子 agent**：每个独立模块一个 general-purpose 子 agent（工具全开），按**中档**运行。喂给它 `design.md` 对应章节 + `tasks/<模块>.md`。
3. **子 agent**：`cd` 到代码根 → 实现 → 写 pytest → **实际运行**三件套 → 把命令输出报回主会话。
4. **主会话**更新 `progress.md` 和 `tasks/<模块>.md`，循环下一批。
5. **并行前提是真解耦**：多个模块要改同一个共享文件，那部分**先串行做掉**再并行其余，避免撞车。

## 代码门禁

- 核心逻辑必须有 pytest；硬件 / IO / ROS2 接口层用 mock，难单测的标「需硬件验证」。
- 完成后**必须实际运行** `pytest`、`mypy`、`ruff check` 并贴输出。未通过不算完成；跑不了要说明原因，**不得谎称通过**。

## 范围（读和改都按需，不全量）

- **只读当前任务相关的文件**，不要一上来全量扫整个代码库。
- 只改当前任务相关模块，不顺手改无关代码，不过度设计。
- 文档冲突以 `design.md` 为设计权威；影响当前任务时停下确认。

## 调试档位

默认**中**；lint / typo 级降**低**；并发 / 跨多文件难 bug 升**高**（低档啃不动硬 bug）。

## 收尾

模块跑绿 → 按 `RULES.md` 调度行报「模块 X 已就绪，可提交」→ 走 `/wf:wrap`。

