关于 notis-reports
用于在 Notis 中读取、创建和修改报告的 Skill。它区分已保存的 HTML 页面与交互式 Space 视图,并提供保留报告身份、检查渲染结果及按需分享的流程。
主要功能
- 01读取并渲染现有报告
- 02在 Space 中保存 HTML 页面
- 03用类型化参数创建交互式报告
- 04修改报告并保留其身份
- 05验证已部署视图和链接
适用场景
- 01检查指定周期的报告
- 02保存完成的 HTML 报告
- 03根据实时数据构建交互式报告
MCP 相关
该 Skill 引用了 notis-apps 的托管 MCP 文档,并通过 Notis 的视图查找和渲染操作读取报告。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mindtheflo/ notis-skills --skill notis-reports安装后在 Claude Code 中输入/notis-reports确认已加载。
附带文件agents/openai.yaml
详细介绍
Notis 报告
报告可以是已保存的页面,也可以是交互式视图,而不是单独的 UI 系统:
- 已保存的页面或报告(独立的 HTML,或用户想要保留的成品报告):放在最合适的 Space 中,默认保存为 Notis Notes 的 Notis reports 文件夹中的笔记。请参阅保存 HTML 页面或报告。
- 交互式报告(带有指定类型参数,例如时间段,以及实时数据读取):是独立编写的 Space 视图,拥有自己的源、数据声明和记忆策略。编辑一份报告不得替换无关视图。
Spaces 推出前保存的页面和报告也会保留在 Notis Notes 中,并维持其存储格式:HTML 页面会全屏打开,保留的报告记录会以报告形式呈现。如果你的运行环境无法访问同级引用,请按名称加载 notis-apps。
读取现有报告
如果原生数据工具能回答问题,请使用这些工具。对于实时数据、图表、筛选器、HTML 或视觉检查,请加载 notis-apps 并遵循其读取和呈现指南(托管 MCP:notis://docs/notis-apps/references/reading.md)。
使用 LOCAL_NOTIS_FIND_VIEWS 确定准确的报告时间段和当前视图链接,然后使用 LOCAL_NOTIS_RENDER_VIEW 呈现视图。检查 Markdown 和图像输出。读取操作不会重新生成历史数据,也不会授权更改源或数据。
保存 HTML 页面或报告
将页面保存在最合适的 Space 中:用户指定的 Space,或在需要保留页面时与工作内容相关的 Space。否则,请将其保存在 Notis Notes 的 Notis reports 文件夹中(或用户指定的 Notes 文件夹中);如果文件夹不存在,Save HTML Skill 会创建该文件夹。“所有笔记”不会显示这些笔记;每个文件夹都会显示其中的所有内容。
- 使用该 Space 为其页面提供的 Skill 保存页面。在 Notes 中,这就是 Save HTML Skill:它会创建笔记(标题、类型“Report”或“HTML page”、文件夹),使用通用原生文件工具上传原始字节,再通过单独的、带修订版本检查的更新附加返回的文件,随后读取笔记并返回其链接。本指南不重复说明该工作流。
- 更正时,应通过同一个 Skill 更新同一页面,绝不要创建近似重复项。Spaces 推出前保留的报告记录无法通过任何工具重写:请将更正后的版本保存为同一文件夹中的新页面,并保留原始页面。
- 仅上传成功并不代表页面已保存,文件 URL 也不是页面链接。请返回该页面在其 Space 中的链接,该链接会全屏打开页面。
- 页面应保持私密。只有在用户提出要求时,才使用 Share 为该页面创建公开链接。Spaces 推出前保留的报告无法分享。
- 如果页面要保存到 Notes,而 Notis Notes 尚未安装,请建议安装。绝不要将页面保存在 Space 之外:不得使用网站、公开粘贴服务或文件托管服务,也不得使用沙盒下载链接。没有单独的 HTML 或报告保存工具。
创建或修订交互式报告
- 先核对身份。针对用户要求的更正,找到现有报告 Space。保留选定的身份和修订版本;名称相似的报告并非同一项产物。
- 对于全新的独立报告,请遵循
notis-apps视图编写、设计和交付指南。将报告的周期/选择声明为类型化参数,在shows或已声明的操作中提供真实数据,明确说明来源上下文,并设置合适的记忆策略。 - 根据用户的要求,选择已捕获结果、实时读取,或两者兼用。除非用户要求修订,否则历史结果应保持已捕获状态。清晰展示单位、周期、方法和来源链接。提供包含实际图表值的
<RenderChartData>,以便精确提取 Markdown。 - 构建后,使用虚构数据验证,并在 390px/1440px 下检查 EN/FR。随后,在用户授权范围内部署已检查的源代码,读取其修订版本,并渲染实际保存的视图。预览并非最终交付记录。
- 返回当前视图的专属链接,并明确说明验证范围。发布到 Store 与保存已授权的报告 Space 更新是两回事。
可选的被动反馈
使用上下文共享来传回用户希望提供给 Agent 的选中文本、评论或批注。反馈属于参考上下文,不代表执行授权,也不会自行发送消息。