代码委派助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/code-delegate-2。
技能介绍
问题背景
在 Cursor、Claude Code 等 Agent 里,对话线程往往同时承担「理解需求」和「改仓库」两件事。复杂功能一次改不完时,模型容易长时间占用工具调用,用户只能干等;更严重的是,同一会话里既写代码又自测,容易带着错误假设过测试,漏掉边界问题。
工作方式
代码委派助手把具体编程动作转交给本机的 ai-assistant CLI,由当前 Agent 扮演编排者与转述者,而不是自己长时间 exec 阻塞回合。
核心机制包括:
- 环境前置检查:首次委派前用
which ai-assistant确认 CLI,用ai-assistant --version验证登录;检查.extensions/write-guard/,缺失时警告--permission-mode bypassPermissions的风险。 - 命令模板:非交互
ai-assistant -p,配合cd工作目录、--output-format text、--max-turns 10、--permission-mode bypassPermissions;修复同一项目 Bug 时用--continue,禁止--dangerously-skip-permissions。 - 异步非阻塞:执行委派后立即回复用户并结束回合;下一条用户消息再用
process poll --timeout 1000查状态,可并行多个-p任务。 - 编写者与测试者分离:迭代修复走
--continue;用户说「测试一下」或验证刚写完的代码时,全新会话从头读源码,像外部审查一样上报通过/失败与 Bug,再转交编写会话修复。 - 结果中继:委派器不直接对用户说话;你汇总变更文件、技术摘要,并适度转述风格,避免整段复制 CLI 输出。
编写、修改、重构、调试、建目录、跑测试与构建、代码审查等场景可自动触发;用户也可发 /code 手动委派。闲聊、纯信息查询不触发。
边界与注意
依赖全局安装的 @ai-provider-ai/ai-assistant-code 与有效 API 密钥;异步设计意味着结果要在用户再次发消息时才会被轮询到。复杂任务可能触及默认 300 秒超时与 --max-turns 10,需拆分任务或调参。未启用写入保护时,委派范围虽应限于项目目录,仍须对委派输出做路径与内容审查。
使用场景
- 在 Agent 对话里要实现新模块,但不想让主会话被长时间 exec 占满,需要把实现交给 ai-assistant 并在下轮消息里轮询结果
- 委派器刚提交的重构在本地测试报错,需要在同一项目目录用 --continue 把堆栈与预期行为传回去迭代修复
- 用户要求对刚委派生成的接口层做一次客观验收,需要开不加 --continue 的新会话从头读源码并汇报失败用例
- 并行处理两个子目录的 lint 与单测修复,需要同时拉起多个 ai-assistant -p 再在用户追问时分别 process poll
适合人员
- 在 Cursor/Claude Code 中常驻编码、希望主对话保持响应、把重活交给本地 ai-assistant 的全栈工程师
- 需要为委派产物建立「编写会话 + 独立测试会话」流程、减少自测盲区的技术负责人
- 维护多包单体仓库、经常要并行委派测试与构建子任务的平台工程师
- 首次接入 SKILL.md 类技能、必须先跑 CLI 与写入保护检查的 Agent 集成维护者