agent-refine-skill

Agent 炼化与主动同步技能。用于第三方 Agent(如 Cursor 等 cowork 后台不可直接监听的外部 Agent)手动调用,主动向 cowork 文档中心传输本次操作的输入、输出与结论。

SKILL.md

GitHub

Agent 炼化技能 (Agent Refine Skill)

技能说明

当使用第三方 Agent(如 Cursor、Claude Code 等 cowork 后台无法直接监听进程状态的外部工具)时,无法通过后台自动采集日志。 本技能由第三方 Agent 在完成任务或阶段性产出后主动调用,将本次改动的上下文、代码 diff 和最终结论写回 cowork 文档中心(会话 ANNOUNCEMENT.md / 群报告)。

调用方式

  1. 从成员设置复制「炼化 Skill 指令」,或 GET /api/docs/refine-prompt?sessionId=...。
  2. 本机工作台已启动时,用与前端相同的 X-ACW-Token(POST /api/bootstrap)调用:
POST /api/docs/refine
Content-Type: application/json
X-ACW-Token: <local-token>

{
  "sessionId": "<当前会话 id>",
  "input": "本次用户需求",
  "output": "git diff 摘要 / 文件列表",
  "conclusion": "验证结果与下一步",
  "source": "agent-refine-skill"
}
  1. 无 API 时,把同结构的「外部 Agent 炼化」章节追加到 journals/sessions/{sessionId}/ANNOUNCEMENT.md。

执行步骤

  1. 收集结构化数据:汇总【输入】、【输出/改动】与【结论】。
  2. 主动上报写回:优先 POST /api/docs/refine;失败再写群报告 Markdown。
  3. 刷新文档中心:工作台右侧「文档中心」会读到更新后的群报告。