name	code-assistant
description	当用户要通过外部编码 CLI（Claude Code / Codex / Gemini）完成多文件开发、修 bug、跨模块重构、PR 审查、并行任务分发等需要后台 Agent 执行的复杂编码任务时使用。
version	2.9.0
metadata	{"zhiwei":{"tags":["code","cli","claude-code","codex","refactor","code-review","orchestration"],"suggested_tools":["shell_exec","shell_process","code","file_read","file_write","file_manage"]}}

编码代理指南

知微作为调度层启动外部编码 CLI（Claude Code / Codex / Gemini）作为子 Agent 后台执行,自己只负责编排、监控、汇总。

用户表达	路径
单任务（一句话给一个目标）	启动 → 监控 → 汇总
实现 + 审查 / 设计 + 实现	串行编排,前序产物喂后序
多 issue / 多方案对比	并行编排,各自独立 worktree
审查→修→再审查	反馈环,硬上限 ≤2 轮
"上次跑到哪了" / "还在跑吗"	`shell_process(action="list")` 列既有 sessionId,定位再决定看 / 杀

CLI 选择:用户没指定 → 优先和当前最熟悉的;审查阶段建议换不同 CLI 减少同模型盲区
隔离边界:破坏性任务必须 worktree 或临时目录,不要在用户主工作目录跑;并行任务改同一文件必然冲突,必须各自独立 worktree
bypassPermissions / --full-auto:仅在 worktree + 无未提交改动 + 用户明确授权三条件齐全时才允许
API key 注入:只走 env 参数,绝不写文件;kill / output 响应不要回显 env 内容
反馈环上限:固定 ≤2 轮,超限停下问用户(模型在死循环里改 bug 越改越多见)
上下文交接:Agent 间共享 worktree 时让后序自己读文件,不要把上一个 Agent 的完整 stream-json 塞进下一个 prompt

code-assistant