SuperAPI AI 工具集

afk-loop

智能体与模型

查看项目

更新于 10-15 19:49

技能介绍

AFK 循环描述团队如何运行 AFK(无人值守)智能体,是围绕仓库 AGENTS.md 契约的人类侧流程。

用途与分工:能否无人值守决定用谁。Copilot 用于 brief 足够完整、无需人在场的情况——变更明确、验收标准可独立核验、没有悬而未决的决策;Claude Code 用于需要人在环中的工作——探索陌生区域、中途出现决策,或需要边做边引导。问题状态 Ready for Agent 本身就意味着它是 Copilot 候选。

Agent brief:当 issue 移入 Ready for Agent 时,由 triage 发布结构化评论,即 agent 的契约。完整 brief 需包含:类别与摘要、当前与期望行为(含边界与错误情况)、关键接口(用描述而非文件路径和行号)、验收标准、以及不在范围内的内容。

指派:先读 brief 再指派,状态只是队列位置,brief 才是门槛。在 GitHub 打开 issue,在 Assignees 中选 Copilot,将 Status 设为 In progress;Copilot 随后打开草稿 PR 并推送提交。命令行指派不可用,因为 Copilot 不在仓库指派人列表中,gh issue edit <n> --add-assignee Copilot 会失败,需用 UI。

审查:每次运行结束都会请求审查,包括失败运行;收到审查请求只表示停止,不代表成功,需先分类。Complete 按普通 PR 并对照验收标准审查;Blocked 表示 agent 提出了无法回答的问题或无法执行的动作,解决后在会话中回复使其继续;Error 不会自行恢复,需决定退回 agent(更好 brief)还是交给人类。不属于这三种状态的 PR 属于 agent 缺陷。

出错处理:可在会话中追加提示引导运行;用 Stop session 停止运行,已推送的提交保留;关闭坏的 PR 而非就地修复,并在 issue 中记录问题。取消指派前先设状态,因为已指派的 issue 会被 frontier 跳过。任务不适合 agent 时设 Ready for Human 或 Waiting on input。运行出错通常应归因于 brief,先修 brief。