将编程任务委派给本地AI代码助手CLI,支持异步执行与会话续接
代码委派助手是一项面向实际任务的技能,主要用于将编程任务委派给本地AI代码助手CLI执行;AI助手自身永不直接编写代码,所有编程操作均通过 ai-assistant -p 命令委派完成;
首次委派任务前,必须验证运行环境就绪;AI代码助手CLI已安装 : 执行 which ai-assistant — 若未找到,提。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
将编程任务委派给本地AI代码助手CLI执行。AI助手自身永不直接编写代码,所有编程操作均通过 ai-assistant -p 命令委派完成。
核心规则:你永远不直接编写代码。所有编程任务通过 ai-assistant -p 委派。
首次委派任务前,必须验证运行环境就绪:
which ai-assistant — 若未找到,提示用户运行 npm install -g @ai-provider-ai/ai-assistant-codeai-assistant --version — 若报认证错误,提示用户运行 ai-assistant 完成登录.extensions/write-guard/ 是否存在写入保护插件。若不存在,警告用户:未检测到写入保护插件。委派器使用
--permission-mode bypassPermissions授予完整文件系统读写权限。强烈建议在执行任务前设置写入保护插件。
仅当第1项和第2项通过后才可执行委派。第3项为警告,用户可选择在不设置的情况下继续,但应被告知风险。
以下场景自动触发委派:
手动触发:用户发送 /code <任务描述>
不触发:闲聊、情感交互、信息查询。
cd "" && ai-assistant -p " " --output-format text --max-turns 10 --permission-mode bypassPermissions
| 参数 | 用途 | 是否必需 |
|---|---|---|
-p |
非交互模式执行 | 是 |
cd " |
设置工作目录(无 --cwd 标志) |
是 |
--output-format text |
纯文本输出 | 推荐 |
--max-turns 10 |
限制执行轮数 | 推荐 |
--permission-mode bypassPermissions |
自动接受文件编辑(需写入保护) | 推荐 |
--continue |
恢复上一个会话(用于调试/迭代) | 修复同一项目Bug时使用 |
禁止使用: --dangerously-skip-permissions
执行超时设为 300 秒(5分钟)。委派器需要时间编写代码。
委派器绝不能阻塞你。 你必须始终保持对用户的响应能力。
步骤1: exec ai-assistant -p "..." → 获取会话ID(如 "marine-sage") 步骤2: 立即回复用户 → "正在处理!马上开始。" 步骤3: 结束你的回合 → 不要再使用任何工具 步骤4: 当用户发送下一条消息时 → 执行 exec "process poll marine-sage --timeout 1000" 步骤5: 若完成 → 转达结果。若未完成 → 告知用户"仍在处理",继续对话
exec ai-assistant -p "..." → process poll → (阻塞!用户无响应等待)
exec ai-assistant -p 后,必须回复用户并结束回合,不再调用任何工具。process 工具。在下一条用户消息时使用 exec "process poll --timeout 1000" 。ai-assistant -p 任务。当用户报告委派器之前编写的代码中存在Bug时:
--continue 标志恢复委派器的会话上下文--continue = 委派器记得它之前编写的内容委派器编写代码后,使用全新的独立会话(不加 --continue)进行测试验证。
原因:编写者存在上下文偏见。全新会话独立阅读源代码,如同外部代码审查者,能发现编写者遗漏的问题。
步骤1: ai-assistant -p "在 projects/X/ 中编写X" → 编写者会话(可用 --continue 迭代) 步骤2: ai-assistant -p "运行并测试 projects/X/,报告Bug" → 测试者会话(始终全新,不加 --continue)
--continue 迭代修复Bug--continue,必须从头阅读源码--continue)--continue| 场景 | 使用 --continue? |
|---|---|
| 修复/迭代委派器刚编写的代码 | 是 |
| 测试/验证委派器刚编写的代码 | 否(全新会话) |
| 运行现有程序 | 否(全新会话) |
| 新项目/新任务 | 否(全新会话) |
委派器不直接与用户对话。你负责转达所有结果。
转达时:
保持技术摘要简洁,不要逐字复制委派器的完整输出。
projects/ 或 workplace/ 目录。.extensions/、LaunchAgents/、认证配置)的写入。--dangerously-skip-permissions — 此标志被明确禁止。--permission-mode bypassPermissions 是正确的标志,与写入保护配合工作。cd "" && 前缀确保委派器在预期目录内操作,永不省略。| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
需要配置对应API Key,详见上文环境配置章节
API Key配置方式:
export API_KEY="your_api_key_here"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统。
ai-assistant -p 以非交互模式执行编程任务,支持 --output-format text、--max-turns 10、--permission-mode bypassPermissions 等参数process poll --timeout 1000 在后续消息中轮询状态,避免阻塞对话--continue 标志恢复先前会话上下文,支持在同一项目内迭代修复Bug--continue)独立审查和测试委派器编写的代码,消除编写者上下文偏见--dangerously-skip-permissions、限制项目范围、审查委派输出执行环境前置检查操作,处理用户输入并返回结果。
输入: 用户提供环境前置检查所需的参数和指令。
输出: 返回环境前置检查的处理结果。
环境前置检查操作,处理输入数据并返回结果环境前置检查相关配置参数进行设置执行命令模板化委派操作,处理用户输入并返回结果。
输入: 用户提供命令模板化委派所需的参数和指令。
输出: 返回命令模板化委派的处理结果。
命令模板化委派操作,处理输入数据并返回结果命令模板化委派相关配置参数进行设置执行异步非阻塞流程操作,处理用户输入并返回结果。
输入: 用户提供异步非阻塞流程所需的参数和指令。
输出: 返回异步非阻塞流程的处理结果。
异步非阻塞流程操作,处理输入数据并返回结果异步非阻塞流程相关配置参数进行设置| 组件 | 说明 | 关键参数 |
|---|---|---|
parser |
解析输入指令 | format, encoding |
processor |
执行核心处理逻辑 | mode, timeout |
output |
格式化输出结果 | format, encoding |
本skill还覆盖以下能力场景: 将编程任务委派给、代码助手、支持异步执行与会、话续接、支持非交互模式、异步轮询、会话续接与独立测、核心能力包括环境、安全防护策略与结。这些能力在上述核心功能中均有对应处理逻辑。
本skill覆盖源skill的以下能力点:
| 源能力点 | 支持状态 | 实现方式 |
|---|---|---|
| Correct Flow | 支持 | 通过核心功能实现对应能力 |
| WRONG (causes blocking) | 支持 | 通过核心功能实现对应能力 |
输入: 用户提供源能力映射所需的指令和必要参数。 处理: 按照skill规范执行源能力映射操作,遵循单一意图原则。 输出: 返回源能力映射的执行结果,包含操作状态和输出数据。
本skill涉及以下领域术语: before, independent, auto, scenario, 项目管理, trigger, translate, 开发规范, prerequisites, iteration, parameters, retry, clear, summarize, tester
处理: 按照skill规范执行领域术语操作,遵循单一意图原则。 输出: 返回领域术语的执行结果,包含操作状态和输出数据。
--continue(修复迭代用,测试验证不用)ai-assistant -p 委派任务,设置 --max-turns 10 和超时 300 秒-sage: 命令参数,用于指定操作选项cd "/home/user/projects/webapp" && ai-assistant -p "在 src/api/ 目录下创建用户认证模块,使用JWT令牌,包含login和register端点,语言:Python,框架:FastAPI" --output-format text --max-turns 10 --permission-mode bypassPermissions
输出:
Session ID: marine-sage Started. Use 'process poll marine-sage --timeout 1000' to check status.
回复用户: "正在处理!马上开始编写用户认证模块。"
cd "/home/user/projects/webapp" && ai-assistant -p "修复login端点的500错误,错误信息:TypeError: object is not subscriptable,位于 auth.py 第42行,预期返回JSON格式的token" --output-format text --max-turns 10 --permission-mode bypassPermissions --continue
cd "/home/user/projects/webapp" && ai-assistant -p "运行 pytest tests/test_auth.py 并报告所有失败的测试用例,包含错误信息和堆栈跟踪" --output-format text --max-turns 10 --permission-mode bypassPermissions
输出:
Ran 8 tests. 2 failed. FAIL: test_login_invalid_password - AssertionError: expected 401, got 500 FAIL: test_register_duplicate_email - AssertionError: expected 409, got 500
# 任务1: 前端组件 cd "/home/user/projects/webapp" && ai-assistant -p "创建React登录表单组件,包含邮箱和密码输入框,使用Tailwind CSS样式" --output-format text --max-turns 10 --permission-mode bypassPermissions # 任务2: 后端API文档 cd "/home/user/projects/webapp" && ai-assistant -p "为 src/api/ 下所有端点生成OpenAPI 3.0规范文档" --output-format text --max-turns 10 --permission-mode bypassPermissions
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
command not found: ai-assistant |
CLI未安装 | 提示用户执行 npm install -g @ai-provider-ai/ai-assistant-code |
| 空输出 | 任务描述不清晰 | 要求用户澄清任务目标,提供更多上下文 |
| 超时(超过300秒) | 任务过于复杂 | 建议拆分为更小的子任务,增加 --max-turns 值 |
| 权限错误: Permission denied | 文件路径不可访问 | 检查项目目录路径是否正确,确认文件权限 |
| API认证错误 | 登录状态过期 | 提示用户运行 ai-assistant 检查登录状态并重新认证 |
| 会话ID丢失 | --continue 无对应会话 |
不使用 --continue,以全新会话重新开始 |
| 写入保护拦截 | 尝试写入受保护配置文件 | 检查目标路径是否在 .extensions/ 等保护目录内,调整目标到项目目录 |
| 异步阻塞 | 直接调用 process 工具 |
改用 exec "process poll 在用户下一条消息时检查 |
| 代码测试失败 | 委派器编写的代码有Bug | 将测试者会话的Bug报告转达,在编写者会话用 --continue 修复 |
A: 委派器采用异步非阻塞流程。执行 ai-assistant -p 后必须立即回复用户并结束回合,在用户发送下一条消息时通过 process poll 检查状态。这确保对话不会被阻塞。
--continue?A: 仅在修复或迭代委派器刚编写的代码时使用 --continue。测试验证代码、运行现有程序、开始新项目或新任务时,必须使用全新会话(不加 --continue),以避免上下文偏见。
--dangerously-skip-permissions?A: 该标志绕过所有权限检查,存在严重安全风险。应使用 --permission-mode bypassPermissions 配合写入保护插件,在保证功能的同时提供安全防护。
A: 可同时执行多个 ai-assistant -p 命令,每个任务获得独立的会话ID。在用户发送消息时,分别使用 process poll 和 process poll 检查各任务状态。
A: 不要自行编写代码。告知用户"编码任务未完成,是否需要重试?",然后以更长超时或更简单的任务描述重试。仅在用户明确要求"你来写"时才自行编写(不推荐)。
A: 写入保护插件在平台层面阻止对配置文件(.extensions/、LaunchAgents/、认证配置)的写入。它是最重要的安全措施,与 --permission-mode bypassPermissions 配合使用,确保委派器仅能修改项目目录内的文件。
A: 编写者存在上下文偏见,可能基于自身假设而非实际代码行为进行测试。全新会话从头阅读源代码,如同外部代码审查者,能发现编写者遗漏的问题。测试者会话永不使用 --continue。
ai-assistant 和配置API密钥--max-turns 10 限制可能不足以完成复杂任务,需手动调整相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习