用途:该技能定义 AI 代理处理 Scout 工作项的完整执行契约,覆盖从接收报告到交付证据的全生命周期。Scout 保存报告、讨论、证据、状态与交接信息,本地仓库承载工程改动。
主要能力:代理自行完成发现、代码修改、验证、提交、非生产环境推送/部署、Scout 备注、证据记录与状态更新;按 bug、task、note 三种类型分别处理,note 需先做 AI 分诊,可安全推断时转为 task。支持单条、下一条与全队列三种范围,全队列按共享根因聚类逐项推进。
使用方式:以 /scout 为唯一执行命令,可附带条目 ID、URL 或自然语言范围。配置读取环境变量 SCOUT_URL、SCOUT_API_KEY、SCOUT_PROJECT_SLUG,缺失时可在命令进程内加载本地 .env,推荐前缀:set -a; [ ! -f ./.env ] || . ./.env; set +a。状态变更前需评估前置条件;进入 review 时在 /items/update-status 内联证据;完成 AI 工作时用一次 /items/resolve 内联证据;补充记录用 /items/add-evidence;人工验收用 /items/verify,人工拒绝用 /items/request-changes。
适用场景:需要代理自主认领并解决 Scout 报告缺陷、已承诺任务或可行动笔记,并保持状态与证据同步的工程流程。
限制:非守护进程,不轮询、不后台循环;仅在用户明确要求时处理无关条目。遇到缺失访问权限、破坏性操作、生产发布、外部沟通、真实资金/供应商操作、密钥泄露或人工验收等硬性门槛时才询问用户。verified 状态保留给人工验收。不得提交或泄露 Scout 凭据、cookie、JWT、API 密钥或 .env 内容。具体项目 slug、密钥格式与错误组作用域等细节以实际环境为准,资料未提供完整示例。