Agent Skill · Single-File Interactive HTML

Onepager · 窄门单页

少即是门 · LESS IS GATE

结论前置细节折叠交互即接口 行动闭环诚实可审计单文件自包含
TL;DR：Onepager 是一个给 AI agent 的「窄门哲学」技能——交付物始终是一个单文件交互式 HTML： 结论 5 秒内可见、细节按需展开、搜索 / 排序 / 勾选 / 复制等窄网关只传最小必要信息，绝不搬运全量上下文。 适合诊断报告、dashboard、计划页、explainer 与 session recap；也用于把「20 行 × 6 列全铺开」的臃肿报告重做回交互单页。
7/7 条法则

Core Laws七条核心法则

01结论前置
标题下 5 秒内出现一句可行动的结论（TL;DR），证据按需下钻。人不该读完报告才知道结论。
02窄网关，不搬运
每个交互都是一扇窄门：搜索框只返回匹配行、聚焦链接只传一个 pane_id、勾选清单只回传增量状态。绝不全量铺开。
03交互是接口，不是装饰
瘦身可以砍内容，绝不砍交互。搜索 / 排序 / 聚焦 / 勾选 / 复制是窄网关本身——把页面瘦成静态文本 = 砍掉人↔agent 协作通道 = 最常见的翻车点。
04行动闭环
诊断必须带「行动」：可勾选、有进度、可一键复制为 Markdown，把决策状态反馈回 agent。
05诚实可审计
标注采集命令 / 时间戳 / 来源；没问题就说没问题（"机器散热健康"），瞬时尖峰标注"非持续"。可复现才值得信任。
06单文件自包含
无 CDN、无构建步骤、离线可用、手机可看。SVG / 图片一律内联（data URI），交付物不绑架用户环境。
07组合产物 main + subs
产物超 200KB 或多页时拆成 main.html（结论 + 窄门）+ 多个自包含 sub-*.html（全量证据），main 始终轻量；改动预览用默认折叠的冻结窄门条 + tag 定位闪烁。

Trigger什么时候用它

要「交互式 HTML / 诊断报告 / dashboard / 计划页 / explainer」 要 session recap / handoff（自动归集会话产物） 要 瘦身臃肿报告（保交互砍内容） 提到 窄门 / small interface / 最小必要信息 全量报告被否掉（"信息太多"）→ 立刻重做 对比设计稿 vs WebApp（4 态漂移基准）

Action Loop反模式自查 · 勾选 + 一键复制

交付前逐条核对（血泪教训） 0/8
▸ 安装 · 评测 · 目录结构（展开查看）

安装：放到 agent 的 skills 目录即可。

cp -r onepager ~/.claude/skills/   # 或 ~/.agents/skills/

评测：自带 2 个评测用例（evals/evals.json：Mac 发热诊断 / 臃肿验收报告瘦身），配套 skill-creator 生态验证。

目录结构：

onepager/
├── SKILL.md                 # 主 skill：法则 + 工作流 + 检查清单 + 反模式
├── README.md                # 中文介绍 + hero
├── assets/hero.svg          # 品牌图（坏/窄门/好 对照）
├── evals/evals.json         # 评测用例
├── scripts/focus-server.cjs # 可选：loopback 聚焦服务
└── rules/                   # 每条反模式的完整规则（正反例对照）

项目：github.com/liush2yuxjtu/onepager · License MIT