03-Subagents子代理

主代理：保存目标、约束和最终决策
  ├─ 认证审查子代理：读取认证链路并报告安全风险
  ├─ 数据审查子代理：检查迁移、事务和回滚路径
  └─ 测试审查子代理：运行测试并报告覆盖缺口
              ↓
主代理：核对证据、处理冲突、汇总交付

name = "reviewer"
description = "Review changes for correctness, security, regressions, and missing tests."
developer_instructions = """
Review the assigned change like a code owner.
Report findings first, ordered by severity.
Every finding must cite a file and symbol or line.
Do not edit files unless the parent task explicitly requests a fix.
"""

# .codex/agents/scout.toml
name = "scout"
description = "Read-only explorer that traces code paths and returns evidence."
model = "<本机可用的快速模型>"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"
developer_instructions = """
Stay in exploration mode.
Read only the files needed for the assigned question.
Trace the real execution path before drawing conclusions.
For every conclusion, cite the file and symbol that supports it.
Do not edit files, install packages, access secrets, or use the network.
Return a concise summary with: facts, uncertainties, and recommended next checks.
"""

# .codex/agents/security-reviewer.toml
name = "security_reviewer"
description = "Reviews authentication, authorization, secret handling, and trust boundaries."
model = "<本机可用的强模型>"
model_reasoning_effort = "high"
sandbox_mode = "read-only"
developer_instructions = """
Review only the assigned security surface.
Prioritize exploitable behavior over style concerns.
Trace untrusted input to privileged effects.
Check authentication, authorization, secret exposure, and fail-open behavior.
Report severity, evidence, impact, and a minimal remediation direction.
Do not modify files and do not claim a vulnerability without evidence.
"""

开个子代理看看登录问题。

派一个 explorer 子代理，只读调查“密码登录成功后偶发跳回 /login”的原因。
范围：src/auth、src/middleware、tests/auth。
已知事实：main 分支不复现，当前分支在刷新 token 后复现。
不要修改文件，不要联网。
返回：真实调用链、最多 3 个有证据的根因候选、对应文件与符号、仍需验证的问题。

请派 scout 子代理调查订单取消流程。
只读取 src/orders 和 tests/orders，不修改文件。
找出状态从 paid 变为 cancelled 的所有入口，并标明事务边界。
完成后只返回路径摘要、证据位置和未知项。

请并行派出 3 个子代理审查当前分支相对 main 的改动：
1. security_reviewer：只看认证、授权、敏感信息和输入边界；
2. explorer：追踪受影响的运行时调用链；
3. default：检查测试覆盖、错误路径和兼容性。

三者都只读，不修改文件，不联网。
等待全部完成后再回复。
最终按严重级别汇总，合并重复发现；每条必须包含文件位置、证据、影响和建议验证方法。
如果某个子代理失败，明确标记失败项，不要把缺失结果写成“未发现问题”。

使用两个 worker 子代理并行实现，文件所有权不得重叠：
- Worker A 只修改 packages/parser/**，实现 CSV 引号转义，并运行 parser 单测；
- Worker B 只修改 packages/ui/**，增加导入错误提示，并运行 ui 单测。

两者都不得修改共享配置、锁文件和公共类型。
如发现必须修改共享文件，停止对应任务并报告依赖，不要自行扩大范围。
等待两者结束后，由主代理检查 diff、运行组合测试并汇总。

/agent

开三个 worker，一起把认证模块重构完。

Worker A 只改 token 校验模块；Worker B 只补现有公开行为的测试；
Worker C 只调查迁移影响并保持只读。任何人不得修改公共接口定义。

[agents]
max_threads = 4
max_depth = 1
job_max_runtime_seconds = 1200

状态：成功 | 部分成功 | 失败
结论：一句话说明结果
证据：文件、符号、命令及关键输出
影响：该问题会导致什么
建议：下一步最小动作
未知：尚未验证的假设

等待所有子代理结束后再汇总。
不要直接拼接它们的回答。
先列失败或缺失的调查，再列已确认发现。
合并重复项；冲突结论必须复核后再采用。
每条结论保留文件和符号证据，并注明是静态分析还是测试验证。
最后列出已运行检查、未运行检查和剩余风险。

尽可能多开代理，把整个仓库所有问题都找出来。

最多并行使用 3 个只读子代理，分别检查认证、数据库迁移和测试缺口。
每个代理最多报告 5 条高价值发现，20 分钟内结束。
证据不足的内容放入“待验证”，不要继续派生子代理。

git status --short
git diff --stat
git diff
git diff --check

git status --short
git diff --stat main...HEAD

name = "auth_reviewer"
description = "Read-only reviewer for authentication and authorization changes."
model_reasoning_effort = "high"
sandbox_mode = "read-only"
developer_instructions = """
Trace login, session, refresh, logout, and authorization paths.
Focus on bypasses, token lifetime, replay, fail-open behavior, and secret exposure.
Every finding must include evidence and an observable impact.
Return no more than five findings, ordered by severity.
"""

name = "test_auditor"
description = "Read-only auditor for regression and missing test coverage."
model_reasoning_effort = "medium"
sandbox_mode = "read-only"
developer_instructions = """
Map changed behavior to existing tests.
Run only the smallest relevant test commands if permitted.
Identify untested success, failure, timeout, and permission-denied paths.
Do not edit tests. Report commands, results, and coverage gaps.
"""

审查当前分支相对 main 的登录相关改动。并行派出两个只读子代理：

- auth_reviewer：检查登录、刷新、退出和授权边界；
- test_auditor：映射行为变化到测试，并运行最小相关测试。

范围限制为 src/auth、src/middleware、tests/auth。
禁止修改文件、安装依赖、联网、读取 .env、提交或推送。
等待两个代理都结束后汇总。

最终先给出线程状态，再按严重性列发现。
每条必须包含证据位置、影响和验证方式。
若测试无法运行，原样报告环境错误，不要把它写成测试通过。