把机械低风险的编码杂活外包给廉价 Qwen 子代理以节省…

当任务是机械、低风险、自包含的编码杂活（批量重命名、格式化、样板代码、查找替换、日志摘要、脚手架、跑构建/测试）时，用 claude-9arm 命令交给 Qwen 子代理执行，把昂贵的 Claude 推理留给真正需要判断的工作。

适用场景

解决思路

1. 用 `claude-9arm -p "<自包含任务提示>" --allowedTools Bash Read Edit Write Glob Grep` 作为默认调用方式；该 flag 列表限定了子代理可无提示使用的工具，否则它会在第一次编辑或命令时卡住等待批准。
2. 注意 alias 内置的 `--allowedTools '*'` 会被 Claude Code 静默忽略并给出警告（`Wildcard tool name "*" is not supported`），这是预期且无害的，真正生效的是你追加的 `--allowedTools`。
3. 对于仅编辑、风险更低的任务，可改用 `--permission-mode acceptEdits`（自动接受文件编辑，但 Bash 仍会提示，因此不要用于验证/构建/测试运行）。
4. 写任务提示时，为每个输入和输出文件使用绝对路径（如 `/Users/tpatinya/proj/src/foo.ts`，而非 `foo.ts`）。
5. 在提示中明确写出输入、输出和验收标准——要改什么、什么算“完成”。
6. 提示中不得引用“我们讨论过的文件”“上面”“前几轮”等上下文，因为 Qwen 子代理对本对话零上下文。
7. 把 Qwen 当作能力强但字面理解的初级工程师：把步骤讲清楚，范围收紧。
8. 委派前估算上下文占用：需读取+打开+写入文件的字节数 ÷ 4 ≈ token 数；若单个任务会拉入大文件或多个文件，就放不下。
9. 把大任务拆成各自只触及有限切片的独立块——例如每次运行一个文件（或几个小文件）、一个目录、一段日志——并作为独立的 `claude-9arm` 调用运行（前台，或按 Return contract 后台并行）。
10. 不要让 Qwen 读它不需要的东西：只指向确切的文件/路径，绝不要说“扫描整个仓库”或读取整棵大树。
11. 验证时留意上下文耗尽的症状：编辑被截断、后续指令被忽略、摘要遗漏了被告知要处理的文件，通常意味着任务溢出——拆得更小后重试。
12. 不要依赖 cwd：Bash 工具的 `cd` 在调用之间会重置，且 `cd &&` 可能触发权限提示；应在提示中放绝对路径，或传 `--add-dir /abs/path` 授予子代理目录访问权限。
13. 默认返回：Qwen 的最终消息打印到 stdout，直接读取。
14. 需要解析结果时：加 `--output-format json` 并提取 `result` 字段。
15. 后台/并行运行多个任务时：重定向到日志并用 Bash 工具的 `run_in_background: true` 运行，完成后读取日志，例如 `claude-9arm -p "<task>" --allowedTools Bash Read Edit Write Glob Grep > /tmp/qwen-<label>.log 2>&1`；把独立任务作为独立后台运行启动，各自完成后收集日志。
16. 按工作流清单执行：1) 确认任务机械且低风险，若需设计判断或本对话上下文就自己做；2) 检查是否适配 Qwen 的 128k 上下文窗口，估算文件占用并把大任务拆成按文件/按目录的有界块；3) 写出带绝对路径和验收标准的完全自包含提示；4) 前台运行 `claude-9arm -p "..." --allowedTools Bash Read Edit Write Glob Grep`，或后台重定向以并行；5) 自己验证输出——Qwen 更便宜也更不可靠，在报告成功前检查文件/结果确实满足验收标准。
17. 可选一次性设置以减少重复提示：通过 `update-config` 技能或编辑 settings 添加 Bash 允许规则 `{ "permissions": { "allow": ["Bash(claude-9arm:*)"] } }`。

适用边界 · 注意事项

• 架构/设计、需要推理的调试、安全敏感的改动、任何需要本对话上下文的任务，或廉价模型改错后代价高昂难以发现的任务。
• 任务本质上太大无法干净切片（需要整个代码库上下文才能做对）时，不要委派，自己保留。
• 不要用 `--permission-mode acceptEdits` 做验证/构建/测试运行，因为 Bash 仍会提示。