关于 report-render
这是一个将对话中已有内容排版为独立 HTML 报告的技能,不改写内容或补充缺失信息。它使用统一模板并提供文本批注层,适合整理计划、变更说明、分析或审计。
主要功能
- 01将对话内容渲染为单个 HTML 文件
- 02沿用来源标题、顺序和措辞
- 03按主题生成短 slug 文件名
- 04为内容块添加锚点
- 05内置文本选择与批注功能
- 06将反馈复制为 Markdown
适用场景
- 01将 planify 计划排版为报告
- 02呈现逐文件变更说明
- 03整理分析或审计内容
- 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。
<slug>= 根据主题生成的简短 kebab-case slug(2 到 5 个有意义的词)。如果渲染的是planify计划,沿用计划中的<prefix>(例如:report-render→.reports/report-render.report.html)。- 如果
.reports/目录不存在,则创建该目录。 - 按照
references/html-report.md编写 HTML:复制脚手架、设计系统(配色、字体、布局、明暗主题)以及可复用区块目录。 - 每个
<section>都带有一个data-annote锚点(计划使用任务 IDT3,其他情况使用标题的 slug);并在</body>前添加批注层:每份报告都必须包含该层。
规则
- 仅包含真实内容:绝不使用占位文本(如“lorem”),也不编造空章节。
- 保留源内容的标题、顺序和措辞。你只负责排版,不改写内容本身。
- 报告必须独立完整:仅包含一个
.html文件,不依赖其他本地资源。
反馈
报告内置一个批注层:读者选中一段内容,附上评论,然后点击“复制反馈”,即可获取一个 Markdown 区块。该区块可粘贴到 planify 中,由它定位每条引用内容并应用反馈。格式和组件详见:references/html-report.md。
完成
以可点击的形式报告写入路径(.reports/<slug>.report.html),并邀请用户在浏览器中打开。说明用户可以为报告添加批注(选择文本),并将反馈粘贴到 planify 中。
评论
支持 Markdown