自研自动汇报

要解决什么问题

多 NPC 或自动化执行体在仓库里「干完活」之后，人类和编排侧（如 OpenClaw）往往只能靠聊天记录或再去扫 diff 才能知道做了什么。口头总结不稳定，字段时有时无，OpenClaw 若靠轮询任务状态，既慢又容易漏报。

本技能把任务结束当成固定节点：在用户表达「完成后汇报」「输出结果总结」「提交后发执行报告」等意图时触发，生成一份结构统一的 Markdown 报告，并可选择主动回传 OpenClaw，而不是等对方来问。

如何工作

通过约定输入驱动输出，核心参数包括 TASK_TITLE、DETAIL_LEVEL（minimal / normal / detailed）、可选的 CHANGED_FILES、DECISIONS、RISKS、NEXT_STEPS、RELATED_LINKS 等；报告默认写入 OUTPUT_PATH（如 ./auto-report-report.md）。

报告模板固定为七块：任务与时间、完成内容、变更文件、关键决策（normal/detailed）、风险与建议（detailed）、后续动作、相关链接。设计上是「结果优先」——先给完成状态与改动，再展开解释。

与 NPC 工作流集成时，推荐在任务结束钩子里调用；REPORT_TO_OPENCLAW 为 true 时，按 REPORT_PUSH_MODE 选择 cnb_issue_comment、cnb_pull_comment、webhook 或 none，并可用 OPENCLAW_MENTION、TASK_ID、REPORTER_NAME 方便关联。上报失败是否中断由 REPORT_FAIL_ON_PUSH_ERROR 控制。技能以独立脚本形态存在，可被其它 skill 复用，无轮询。

适用边界

• 依赖调用方在结束时传入或汇总真实字段；CHANGED_FILES 等为空时，对应章节会偏薄。
• Webhook 模式需正确配置 OPENCLAW_WEBHOOK_URL；推送通道与权限由所选 REPORT_PUSH_MODE 决定。
• 详细程度由 DETAIL_LEVEL 控制，不会自动从代码库推断决策与风险，需执行体或上游显式提供 DECISIONS、RISKS。