三、工作流篇

Q13. 你接到一个”中等复杂度的新功能”任务, 应该怎么用 agentic 工具拆?

参考答案 (一种典型流程):

  1. 进入 plan mode (Shift+Tab 或对应快捷键), 只读探索代码.

  2. 用 Explore sub-agent 并行搜索相关文件 (找入口、找数据流、找测试).

  3. 用 Plan sub-agent 或主对话本身产出TDD 风格的方案:

    • 先写验收标准 / 测试用例

    • 再写最小实现

    • 再写验证策略

  4. 用 ask-codex 或 ask-gemini 找第二意见 (cross-model review), 修补盲点.

  5. 用 AskUserQuestion 让用户在关键设计岔路上拍板.

  6. ExitPlanMode → 进入 acceptEdits 模式落地.

  7. 写代码前先写 (或更新) 测试, 然后让 agent 实现, 实时跑测试.

  8. 完成后用 /review 或 superpowers:requesting-code-review 自审.

  9. 提交前过一遍 verification-before-completion skill.


Q14. 什么时候应该开 sub-agent, 什么时候不该?

参考答案:

  • 应该开:

    • 要读 10+ 个文件做调研 (Explore).

    • 要跑大量 grep / find / 日志分析, 输出会很噪.

    • 要做独立的代码 review、安全 review.

    • 要并行做多个无依赖的子任务 (dispatching-parallel-agents).

  • 不该开:

    • 任务只需要 1-3 个工具调用 → 主对话直接做更快.

    • 任务需要主对话保留思考过程用于后续决策 → 开 agent 会丢上下文.

    • 任务需要多次交互式确认 → sub-agent 不能问用户.

    • 任务就是”读一个已知路径” → 直接 Read, 别用 agent.


Q15. 怎么避免主对话上下文被污染?

参考答案:

  1. 大量读取 / 调研 → 用 Explore sub-agent, 只回传 summary.

  2. 长输出命令 → 用 head/grep 收敛, 或写进文件再让 agent 选读.

  3. 重复性任务封装成 skill, 避免把规则反复打字进对话.

  4. 及时 /compact 在阶段性里程碑之后压缩.

  5. 不要让 agent 反复读同一文件 —— 文件状态由 harness 维护, 改完不需要重读验证.

  6. 把”长期记住的事”写进 CLAUDE.md / auto memory, 不要靠对话里讲一次.

  7. MCP 工具按需加载 —— 不要一次性把所有 MCP server 都连上.


Q16. 代码出了 bug, 你会怎么用 agentic 工具调试?

参考答案:

  1. 先用 superpowers:systematic-debugging skill 进入系统化排查模式.

  2. 不要急着改代码 —— 先复现, 写一个能稳定触发 bug 的最小用例 / 测试.

  3. 让测试先失败, 确认理解了 bug.

  4. 用 Explore 找出 bug 发生路径上的所有相关文件.

  5. 假设 → 验证 → 修复 (而不是猜测式打补丁).

  6. 修完后跑全部相关测试 + verification-before-completion.

  7. 复杂 bug 用 codex:rescue 让 Codex 做独立诊断, cross-check 思路.


Q17. 在多人协作的仓库里, 如何让 agentic 工作流”团队化”?

参考答案:

  • 共享层:

    • 仓库根 CLAUDE.md / AGENTS.md —— 团队所有人共享的硬规则 (代码风格、PR 流程、禁止事项).

    • .claude/skills/、.claude/agents/、.claude/commands/ 全部入 git.

    • .claude/settings.json —— 共享 permission allowlist、hooks.

  • 个人层:

    • CLAUDE.local.md (gitignore) —— 个人偏好.

    • .claude/settings.local.json —— 个人 permission 覆盖.

  • 分发机制:

    • 把团队公共能力打包成 plugin, 放到内部 marketplace, 新成员一条命令 /plugin install 上手.
  • 审计:

    • hooks 在 PreToolUse 上对敏感操作记审计日志.

    • PR 模板要求贴出 agent 协作的关键决策点.