mcpField
R
report-render

report-render

github.com/aymericderbois文档处理40 次安装
代码仓库

关于 report-render

这是一个将对话中已有内容排版为独立 HTML 报告的技能,不改写内容或补充缺失信息。它使用统一模板并提供文本批注层,适合整理计划、变更说明、分析或审计。

主要功能

  1. 01将对话内容渲染为单个 HTML 文件
  2. 02沿用来源标题、顺序和措辞
  3. 03按主题生成短 slug 文件名
  4. 04为内容块添加锚点
  5. 05内置文本选择与批注功能
  6. 06将反馈复制为 Markdown

适用场景

  1. 01将 planify 计划排版为报告
  2. 02呈现逐文件变更说明
  3. 03整理分析或审计内容
  4. 04收集报告批注并反馈给 planify

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aymericderbois/skills --skill report-render

安装后在 Claude Code 中输入/report-render确认已加载。

附带文件references/html-report.md

详细介绍

HTML 报告渲染

你只负责排版,不做决定。将对话中已有的内容整理成一份独立的 HTML 报告。不再提出问题、不做任何决定,也不编造所给内容中没有的信息。思路与 planify-write-plan 相同,但输出为 HTML。

输入

待渲染的内容来自对话。典型情况有三种,均使用同一模板处理:

  • planify 生成的计划(任务、验收约束);
  • explain-your-changes 生成的变更说明(差异 + 按文件说明);
  • 用户直接提供的任意内容(分析、审计、备注……)。

如果待排版的内容有歧义,采用对话中最近的相关内容。

输出

单个文件:.reports/<slug>.report.html。

  1. <slug> = 根据主题生成的简短 kebab-case slug(2 到 5 个有意义的词)。如果渲染的是 planify 计划,沿用计划中的 <prefix>(例如:report-render → .reports/report-render.report.html)。
  2. 如果 .reports/ 目录不存在,则创建该目录。
  3. 按照 references/html-report.md 编写 HTML:复制脚手架、设计系统(配色、字体、布局、明暗主题)以及可复用区块目录。
  4. 每个 <section> 都带有一个 data-annote 锚点(计划使用任务 ID T3,其他情况使用标题的 slug);并在 </body> 前添加批注层:每份报告都必须包含该层。

规则

  • 仅包含真实内容:绝不使用占位文本(如“lorem”),也不编造空章节。
  • 保留源内容的标题、顺序和措辞。你只负责排版,不改写内容本身。
  • 报告必须独立完整:仅包含一个 .html 文件,不依赖其他本地资源。

反馈

报告内置一个批注层:读者选中一段内容,附上评论,然后点击“复制反馈”,即可获取一个 Markdown 区块。该区块可粘贴到 planify 中,由它定位每条引用内容并应用反馈。格式和组件详见:references/html-report.md。

完成

以可点击的形式报告写入路径(.reports/<slug>.report.html),并邀请用户在浏览器中打开。说明用户可以为报告添加批注(选择文本),并将反馈粘贴到 planify 中。

评论

支持 Markdown