name: study-report description: "学习复盘报告：自动采集近 48h 全部 Agent 工作痕迹（Claude Code/Codex/Trae/WorkBuddy/OpenClaw/元宝/Hermes/工作区）→ 三问追问（一次呈现三问，支持一次性连答：三段用 --- 分隔或 JSON；缺项再逐问补一轮）感受 → 生成 skill-present 级 HTML 复盘 PPT → Storage+Gogs 双通道发布。适用：(1) 培训/研修结营复盘 (2) 数字生命工作总结 (3) 一键转发给学员 Agent 代跑全流程。"

description_en: "Learning retrospective: auto-collect 48h of all Agent work traces, ask the user three reflection questions, build a skill-present-grade HTML PPT report, and publish via Storage+Gogs dual channels. Triggers: training retrospective, agent work summary, forwardable one-click skill."

Study Report — 学习复盘报告技能

装给任何 Agent（Claude Code / Codex / WorkBuddy / Trae / Hermes / OpenClaw / 元宝）： 自动采集近两天全部 Agent 工作痕迹 → 追问用户感受 → 生成 HTML 复盘报告 PPT → Storage+Gogs 双通道发布。

六段流程（严格按序执行）

第 0 段 · 安装前置自检（borrow 07-git.md 已验证链路）

node <skill_dir>/scripts/precheck.mjs

按序自检三环节，打印「安装体检表」，任一环节不通按提示走恢复流程：

平台身份：读 ~/.fmode/config/user.json 的 fmodeApiToken（真实字段名，非 sessionToken）→ HEAD 探测平台可达
Git 账户（幂等，07-git.md 已验证链路）：POST server.fmode.cn/api/functions {token, path:"/gogs/admin/proxy", params:{method:"POST", path:"/admin/users", body:{...}}} → 201 新建 / 200 幂等返回新 token.sha1（忘密码不找回，重调即得）；401/209 → 走「对话式验证码登录」恢复（手机号 → VerifyCode → 换 sessionToken）
Storage 能力：探测 obsutil config / OBS_AK 环境变量；无 → 不阻塞（报告走 Gogs 降级通道），提示可选配置

第 1 段 · 采集（近 48h 全量扫描，跨 Agent 工具）

node <skill_dir>/scripts/collect.mjs --hours 48 --out /tmp/study-report-collect.json

所有工具路径探测存在才扫：Claude Code（~/.claude/projects/*/*.jsonl）、Codex、WorkBuddy、Trae、OpenClaw、元宝、Hermes Agent（~/.fmode-harness-agent/）、工作区产出物（~/projects、~/git-repos、~/Desktop 48h 内 .md/.html/.pdf/.docx/.xlsx）。

产出采集清单（每条：来源工具/时间/类型/摘要/产出物路径/URL）——先给用户看，缺哪类工具提示用户确认路径，不阻塞。

第 2 段 · 追问（采集完成后，三轮固定问题）

node <skill_dir>/scripts/ask.mjs --collect /tmp/study-report-collect.json --answers /tmp/study-report-answers.json

第一问·过去：企业之前 AI 落地不够原生、不够性感的地方？痛点或疑惑？
第二问·现在：这两天具体感受与收获？（成果已从采集拿到，只问感受 + 哪个项目有感觉）
第三问·未来：学到的细节之后，想回企业落地或探索的方向？

口述与采集素材自动关联标记（说到某项目 → 引用该 session/文件证据）。用户不答 → 用采集数据先行出报告，标注【待补充：用户口述】，不阻塞。

第 3 段 · 报告（HTML PPT，skill-present 标准）

node <skill_dir>/scripts/build-report.mjs --collect /tmp/study-report-collect.json \
  --answers /tmp/study-report-answers.json --name "姓名" --enterprise "企业名" --out /tmp/study-report-out

≥10 屏结构：封面（姓名/企业/日期）→ 48h 数据全景（数字动画/工具分布）→ 交付物墙（HTML 用 iframe 嵌套，在线项目标记可嵌）→ 精选工作时刻线 → 过去痛点 → 两天感受（关联素材）→ 未来方向 → 数据附录 → 收口金句。 lib 全套独立复制（deck.js/tokens/base.css/canvas-scale/gsap 逐文件校验，v2.4.1 base.css 缺失教训）；数据优先/证据链/来源标注。

第 4 段 · 发布（双通道）

node <skill_dir>/scripts/publish.mjs --dir /tmp/study-report-out --name "姓名" \
  --gogs-token <precheck所得token> --gogs-user <precheck所得用户名>

Storage（主）：uploader.mjs put → study-report/<姓名>-<日期>/report.html → 公开 URL（上传后 HEAD 验证）
Gogs（降级/并行）：自检 token 建 study-report-<姓名拼音> 仓 → push 报告+素材（ls-remote 验证 SHA）
ZIP：打包 → Storage downloads/skill-study-report.zip（CDN 映射探测，未映射给 Storage 直链）
状态门禁分别报告：Storage/Gogs/ZIP 三个独立状态；Storage 缺权限走 Gogs，Gogs 也失败 → 本地文件路径 + 手动上传指引。不伪造任何发布结果。

第 5 段 · 交付话术

发布完成后把两条 URL（Storage + Gogs）和 ZIP 链接都给用户，附 README 中的「一键转发话术」。

凭据纪律（零暴露）

fmodeApiToken / Gogs token / STS / AK/SK 只运行时读取，绝不写入仓库、日志、报告或对话
precheck/publish 输出只显示 token 尾 4 位
不伪造任何采集/发布结果；失败如实报告并给恢复指引

故障对照

症状	根因	对策
precheck 环节1 ❌	user.json 无 fmodeApiToken	登录 FMODE Studio 保存配置，或对话式验证码登录
precheck 环节2 401/209	sessionToken 失效	对话式验证码登录恢复（07-git.md 标准节）
precheck 环节3 🟡	无 OBS 凭据	不阻塞——Gogs 降级通道；可选按 skill-storage init 向导配置
collect 全 0 条	工具路径未覆盖	用 `STUDY_REPORT_EXTRA_SCAN_ROOT` 追加扫描根；确认工具安装路径
build-report 报 lib 缺失	安装不完整	重新克隆仓库（lib 逐文件校验会精确报缺哪个）
publish Storage 🟡	凭据链 4 级全空	走 Gogs 通道；两者都失败给本地路径+手动上传指引
CDN ZIP 404	fmode.cn/downloads/ 源站未映射	用返回的 Storage 直链；官方映射后自动生效

SKILL.md 6.1 KB История Исходник