用途
droid 技能用于调用 Factory Droid CLI:创建新会话或续接指定会话、把任务交给 Droid 执行、查看本地会话记录,以及处理执行过程中的 AskUser 提问和权限请求。同时可用于回答关于 Droid CLI 安装、模型和执行方式的问题。普通咨询只核对并回答,只有用户明确要求把任务交给 Droid 时才向会话发送消息。
主要能力
- 新建会话:使用用户指定的项目目录,未指定时使用当前工作目录,开始前先确认目录存在。
- 续接会话:沿用已有会话的原有目录,在同一会话继续未完成部分。
- 一次性执行:通过 droid exec 运行任务,并可从 JSON 结果读取 session_id 用于后续续接。
- 交互执行:需要在执行中接收 AskUser 或权限请求时,使用保持标准输入输出打开的长驻 JSON-RPC 进程,直接调用 Droid CLI,不要求安装 SDK 或启动额外服务。
- 历史查询:使用 droid search <关键词> --json 搜索本机记录,或在已确认位置只读目标会话文件;不通过发送新消息读取历史。
- 模型选择与回退:默认 Claude Sonnet 5.5(claude-sonnet-5-5,推理等级 xhigh);确认标准额度耗尽后回退到 Kimi K3.1 Pro(kimi-k3.1-pro),使用该模型默认推理等级。
使用方式
开始前先确定用户要新建会话、续接指定会话、查看记录,还是只了解命令;不根据相似标题或路径猜测目标会话。按需运行 command -v droid、droid --version 和 droid exec --help。安装、更新、登录或更改全局配置应符合用户实际请求,不自动执行。
一次性任务或已结束会话的下一轮使用 droid exec,普通模式默认只读,需要修改时按用户已授权范围选择 --auto 等级,不为绕过限制自动使用 --skip-permissions-unsafe。示例:
droid exec --cwd /path/to/project --model claude-sonnet-5-5 --reasoning-effort xhigh --output-format json "任务内容" droid exec --session-id SESSION_ID --model claude-sonnet-5-5 --reasoning-effort xhigh --output-format json "下一轮任务"
用户在终端操作时使用 droid 启动交互界面,续接可用 droid --resume <session-id>。需要核对实际会话配置时,可用 --output-format stream-json 查看初始化事件的 model 和 reasoning_effort。
适用场景
- 将编码或其他任务委派给 Droid CLI 执行。
- 在同一会话中多轮跟进未完成工作。
- 查看或搜索本机 Droid 会话历史。
- 处理执行中的 AskUser 提问与权限确认。
- 查询 Droid CLI 安装命令与模型选择方式。
限制与注意事项
- 一次性 droid exec 不提供 AskUser;-s 是续接参数,不是查询运行状态或获取 AskUser 的命令。
- 不能把命令已启动当作任务完成,需检查进程退出状态、is_error、结果和错误信息。
- 不因普通网络错误、认证失败或无法确定额度类型的限流而切换模型;切换前确认当前轮次已停止并检查原会话与已完成工作。
- 发送结果不明、进程断开或请求超时时,先核对会话记录与当前状态,不自动重发任务、重复答复或创建替代会话。
- 会话记录、事件和工具输出可能包含代码或敏感信息,只读取、转述任务所需内容,不输出凭据,也不把凭据放入提示词或命令参数。
- 安装方式、参数和协议可能随版本变化,以本机 --help 和 Droid CLI 文档为准。用户明确要求安装时,macOS 可使用 brew install --cask droid,也可使用 npm install -g droid;npm 版本默认不自动更新,安装后检查 droid --version,按需让用户完成登录。
- 可用模型以当前环境和 Factory 模型文档为准;其余设置沿用现有配置,本技能的选择不修改全局默认设置。
- 具体收费、价格等信息暂未提供。