Imported from 371684029/oh-my-co-work (skills/agent-refine-skill/SKILL.md). Install upstream with npx skills add 371684029/oh-my-co-work --skill agent-refine-skill. Copyright stays with the author.

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"
}

3. 无 API 时，把同结构的「外部 Agent 炼化」章节追加到 journals/sessions/{sessionId}/ANNOUNCEMENT.md。

执行步骤

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