SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场recap-topic

recap-topic

写作与研究

查看项目

更新于 10-15 09:50

技能介绍

用途

recap-topic 是 Recap Studio 的 topic 模式编排技能。当用户输入 /recap topic、/recap "<subject>"，或要求 Recap Studio "make a one-page explainer"、"summarize a topic"、"build a visual…" 时触发。其目标是产出一个可发布的一页式教育网站，底层由带类型的 RecapPageContent JSON 对象和一份验证报告支撑。

主要能力

  • 解析用户意图：主题、受众、深度、风格、动画；默认值来自 recap-studio.config.ts 的 loadConfig()（位于 packages/content-pipeline）。
  • 规划研究强度：fast | balanced | deep；在 economy 成本模式下，若存在 fixture 则优先使用。
  • 通过子代理流水线协作：research-scout 收集 5–12 个可靠一手来源（只读）；source-librarian 为来源评分、构建 sourceMap[]、标记需要更多支持的论断；learning-architect 产出 5 分钟学习路径（一句话答案、为何重要、关键想法、示例、类比、常见误解、术语表、要点），每个重要论断必须引用至少一个来源 id；visual-story-designer 定义视觉概念、章节节奏、图表（Mermaid 或 SVG）、对比、时间线。
  • 前端构建：frontend-builder 输出 <root>/apps/recap-web/src/content/<slug>.json，并同步更新 <root>/apps/recap-web/src/lib/active-content.json，使页面渲染新 slug；两步写入必须在同一步完成。
  • 并行验证：fact-checker、beginner-reviewer、accessibility-reviewer、ux-design-reviewer、performance-reviewer、security-privacy-reviewer、skeptical-reviewer 组成验证板。
  • 聚合评分：若任一维度低于目标，则修补并只重跑失败的评审者；最多迭代 3 次，并如实记录任何阻塞项。
  • 渲染自包含页面：运行 node scripts/render-html.mjs <slug>（或 pnpm render <slug>），写出 artifacts/<slug>/recap-<slug>.html，一个深色模式 HTML 文件，所有 CSS 内联、零 JavaScript，双击即可离线打开。优先使用 kind: "svg"（手写内联 SVG）而非 kind: "mermaid"，以便独立文件完全可视化。可选运行 pnpm --filter recap-web build 用于托管/Vercel 轨道。
  • 打开文件并询问部署：按平台打开文件（macOS 用 open，Linux 用 xdg-open，Windows 用 start）。然后检查 Vercel 是否已配置（vercel/.vercel 目录、环境变量 VERCEL_TOKEN，或 recap-studio.config.ts 中 deploymentMode !== "disabled"）。若已配置，询问 "Deploy to Vercel?"，仅在明确同意后运行 pnpm deploy:preview；否则干净跳过。未配置 Vercel 时不得提及部署。
  • 最终报告：以 Final report 块结束，说明 HTML 路径、评分和部署决定。

使用方式

  • 触发命令：/recap topic、/recap "<subject>"，或自然语言请求。
  • 若用户只输入 /recap 或 /recap session//recap repo，则移交给 recap-session 技能；若传入主题，则在本技能继续。
  • 目标仓库解析（必须在第 7 步之前完成）：按顺序解析可写仓库根目录——$RECAP_STUDIO_ROOT（若已设置且包含名为 "recap-studio" 的 package.json）；~/projects/recap-studio（若是 recap-studio 仓库的 git checkout）；process.cwd()（若看起来像 recap-studio checkout，即含 apps/recap-web/package.json）；仅作为回退，使用插件缓存 ~/.claude/plugins/cache/10x/recap-studio/<version>/。若选择插件缓存作为目标，最终报告必须包含一行警告："wrote to plugin cache, content is ephemeral; clone the fork to persist"。最终报告中回显解析出的根目录，以便未来漂移在记录中可见。参见 docs/known-issues.md#plugin-cache-write-target。
  • 演示：pnpm demo:latest-ai-models 会为 "Latest AI models" 重新生成离线 fixture 并在无网络调用的情况下重新验证。

适用场景

适合需要把某个主题快速转化为一页式、可离线打开的教育网页的场景，尤其是希望内容有来源支撑、经过多维度质量评审、并可选部署到 Vercel 的流程。

限制与硬性规则

  • 绝不捏造引用；标记不确定性。
  • 除非 recap-studio.config.ts 存在、用户已确认且相关 API key 在环境变量中，否则绝不调用网络。
  • 绝不写入 .env、密钥或任何匹配 /secrets/ 的路径。
  • 遵守 RECAP_STUDIO_FIXTURE_ONLY=1，即使密钥存在也强制 fixture 模式。
  • 移动优先，对减少动态效果（reduced-motion）安全。
  • 评分目标：Facts 9、Beginner 9、A11y 9、UX 8、Perf 8、Sec 9、Simplicity 9。
  • 最终报告需包含文件摘要、架构摘要、运行的命令、lint/typecheck/test/build 结果或阻塞项、演示命令、评分、部署/邮件说明、环境变量、已知限制。
  • 关于收费、价格、平台支持范围等未在资料中明确的信息，暂未提供。