1实现原理 · 为什么它能做到
这个 skill 不是可执行程序，而是「一个目录 = 一个模板」：SKILL.md 的 frontmatter 供选择器展示，正文（body）就是发给模型的提示词；加模板＝加目录，不需要改 TypeScript。
next/src/lib/templates/loader.ts
routes rescan disk and the client refetches `/api/templates`.
注：同一文件头注释写明目录约定：SKILL.md（frontmatter + prompt body）/ example.md（可选输入样例）/ example.html（可选预览）。本 skill 目录内正是这一结构。
实际下发提示词 = 平台共享设计指令（SHARED_DESIGN_DIRECTIVES）+ 本 skill 的 SKILL.md 正文 + 用户内容，由 assemblePrompt 拼成一条 prompt。
next/src/lib/templates/shared.ts
Wrap a per-template instruction body with the shared design directives and
注：所以本 skill 的正文只负责「版式/风格/组件库」这一段；输出纪律（单文件 HTML、必须用用户真实数据、内容驱动数量）来自共享指令，模板作者不必重复声明。
成稿不走文件系统：共享指令明令禁止 Write/Edit/Bash 等文件工具，要求模型把整份 HTML 直接作为回复正文流式输出（stdout 由前端捕获落盘）。
next/src/lib/templates/shared.ts
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
注：这是「skill 自身零写盘」的机制来源：写文件的是宿主前端，不是 skill；本目录内也无任何脚本。
这是全批「约束最硬」的模板：SKILL.md 用「硬性视觉签名 — 不许改」一节把画布、墨色、唯一色彩、字体、行高、禁止项全部钉死。
next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- **画布**: 暖羊皮纸 `#f5f4ed` (永远不用纯白 `#fff`)。次级背景 `#efeee5`。
注：同节还规定主文字 #1f1d18、次文字 #6b665b、唯一 accent 墨蓝 #1B365D；禁止 drop-shadow/blur/圆角≥8px/渐变/霓虹/rgba。等于把「编辑级排印」变成可机械校验的规则集，模型自由发挥的空间主要留给内容组织。
单色 accent 的纪律写成了一句可判定的话：所有 accent 只能用一个墨蓝色，严禁多色。
next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- **唯一色彩**: 墨蓝 `#1B365D` ——所有 accent (链接、tag 描边、重点数字、引用左 rule) 只能用这一个色, 严禁多色。
注：样例 to 遵守：ink-blue 只用于关键词与 tag（`.ink-blue { color: #1B365D; }`），其余全部靠字号/衬线/留白分层——这正是原模板「No hard drop shadows / 靠对比而非色彩」的思路。
反 dashboard 的取向被显式写进设计准则，并给出替代手法（hairline 描边代替阴影）。
next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- "Composed pages, not dashboards." 不要堆 KPI 卡, 不要堆 emoji 图标, 不要 hero gradient。
注：同段给出正面替代：「Ring or whisper only, no hard drop shadows.」阴影只能是 `0 0 0 1px #d4d1c5` hairline。这是本 repo 里少见的「禁止 + 给替代」成对出现的写作方式。
按文档类型给 8 种可选版式骨架（One-Pager / Long Doc / Letter / Portfolio / Resume / Slides / Equity Report / Changelog），由用户内容判断选哪种，而不是固定一套页面。
next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- **One-Pager** — 顶 logotype (Charter italic) + 标题 + lede + 3 列要点 + 底脚 metadata。
注：同一节里 Slides 类型也明确「页数由【用户内容】决定（短内容 6 页起步, 长内容应更多）」，把内容驱动数量落到具体文档类型上。
成稿技术约束在本模板内被再次声明：单文件 HTML、用 Tailwind CDN、不引外链图片、占位用色块 + 1px 墨描边。
next/src/lib/templates/skills/doc-kami-parchment/SKILL.md
- 单文件 HTML, 用 Tailwind CDN; 全文中英混排时加盘古之白; 不要外链图片, 占位用 paper-tint 色块 + 1px ink 描边。
注：这是本批 9 个模板里唯一在 SKILL.md 里点名 Tailwind CDN 的条目，也是本 skill 出现可预期外链的唯一来源（见 security.reason）；样例 example.html 确实引了 cdn.tailwindcss.com。
成稿样例本身是一份「像被排版过的纸」的 one-pager：folio 顶栏 + kicker + 大标题 + 3 列 pillar + 页脚，全部靠 Tailwind 类与 4 个色值。
next/src/lib/templates/skills/doc-kami-parchment/example.html
<span>KAMI · Open Design</span>
注：样例 4.3KB、无图片、无脚本（只有 Tailwind CDN script）；example.md 是配套的输入样例（Open Design Studio Issue №26），说明「一份 markdown 进 → 一页羊皮纸出」的用法。
服务端 /api/convert 只做三件事：按 templateId 从磁盘读 skill、拼 prompt、spawn 本地 agent CLI 并 SSE 流转发输出。
next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
注：同文件先 `const skill = loadSkill(templateId);`（无此模板即 400），再交给 invokeAgent；skill 目录本身不产生进程、不联网。
2核心能力
01严肃排版的羊皮纸文档系统，覆盖 one-pager / 长报告 / 信函 / 简历 / 财报 / changelog / portfolio
02单色纪律：唯一 accent 墨蓝 #1B365D，层级靠字号与衬线对比
03暖纸画布 #f5f4ed 与 hairline 描边替代阴影
048 种文档版式按内容自选（含 3 列要点 one-pager）
05中英混排细节：一种语言一种衬线 + 加盘古之白 + 中文回退 Noto Serif SC
06自带配套输入样例，说明 markdown → 文档的用法
3外部依赖
| 类型 | 依赖 |
|---|---|
| network | Tailwind CDN（SKILL.md 明令成稿引入；静态样式，不传数据、不需凭证） |
| network | Google Fonts（样例成稿的字体来源；离线回落本地衬线） |
| package | WeasyPrint（SKILL.md 提及的打印/PDF 渲染器名——决定「用 solid hex 不用 rgba」的设计取舍） |
4风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 运行时外链（本批唯一） — SKILL.md 要求用 Tailwind CDN，成稿必然请求 cdn.tailwindcss.com；离线/内网环境下 Tailwind 类失效，只剩样例里的内联 CSS 兜底。虽不含数据外发，仍建议在详情页标注。
- 样例自身轻微越界 — 样例用 #3a382f 作正文色（不在 SKILL.md 墨色清单内），且未用首选 Charter 字体；复制样例当规范会与文字规范有偏差。
- 打印场景依赖本地字体 — TsangerJinKai02 / Charter / YuMincho 多为本地或商业字体，机器没有时回落 Noto Serif，中文长文的版面密度会变。
- 约束多、自由度低 — 禁止项密集，模型若被用户要求「加个彩色图表/emoji 图标」，规则与用户诉求会冲突，需人工裁定（SKILL.md 的取向是服从规则）。
- 注入面 — 用户内容逐字进 prompt；成稿在宿主预览 iframe（allow-scripts allow-same-origin）中渲染。
风险提醒：绿色，放心使用。判级对象＝skill 自身目录（SKILL.md + example.html + example.md）：零脚本、零凭证读取、零写盘指令、无执行期网络调用代码。按批4 终版细则，「产物引用」与「执行期外发」分开判：SKILL.md 末条【设计准则】点名的 Tailwind CDN 属**产物期引用**——它写进的是生成出来的 HTML，由浏览器在打开成稿时拉取，skill 执行时不发生任何外发；且该端点只提供静态样式/字体，不传用户素材、不查服务后端、不消耗账号额度、不读凭证，故**不判级**（维持 green）。目录内实际出现的端点逐条自证：① https://cdn.tailwindcss.com（SKILL.md 设计准则末条 + example.html 第 6 行 <script>）；② https://fonts.googleapis.com（example.html 的 Source Serif Pro / Noto Serif SC / IBM Plex Mono 字体链接）；③ https://github.com/tw93/kami（frontmatter example_source_url，仅出处署名，非调用）。宿主侧另需知悉（只作说明、不判级）：共享指令要求成稿引 CDN、预览 iframe 用 sandbox="allow-scripts allow-same-origin"、本地 agent CLI 被 spawn。风险方面无 orange 要件（不把用户素材送外部生成/服务后端）、无 red 要件（无逆向/冒充/绕过/安全降级）。
5第二遍独立确认
- [ok] 「暖羊皮纸 #f5f4ed（永远不用纯白 #fff）」 — 样例 body background: #f5f4ed；全文无 #fff 背景（tag 用 #efeee5）。
- [ok] 「唯一色彩墨蓝 #1B365D，严禁多色」 — 样例彩色只有 #1B365D（.ink-blue 与 tag 文字），其余为纸色/墨色/中性灰。
- [discrepancy] 「一种语言一种衬线（Charter / Source Serif Pro / Noto Serif SC）」 — SKILL.md 首选英文衬线是 Charter（fallback: Source Serif Pro），样例直接用 fallback 族名 'Source Serif Pro' 作主字体——符合「允许 fallback」的字面，但成稿与首选有差；且未加载 Charter。
- [discrepancy] 「绝不：drop-shadow / 圆角 ≥ 8px / 渐变 / rgba」 — 样例未用 drop-shadow/渐变/圆角，但正文段落用 style="color:#3a382f" 引入了 SKILL.md 墨色清单外的第四种文字色（清单只给 #1f1d18 主文与 #6b665b 次文）；属轻微越界，不影响单色 accent 纪律。
- [ok] 成稿运行时外链（Tailwind CDN） — SKILL.md 明写「用 Tailwind CDN」，example.html 确有 <script src="https://cdn.tailwindcss.com"></script>；已在 external_deps 与 security.reason 逐条自证。
- [ok] 带 example.md 输入样例 — example.md 为 Open Design Studio Issue №26 的 markdown，与 example.html 内容一一对应（Berlin 坐标、Apache 2.0、四支柱）。
- [ok] 出处标注真实（非虚构来源） — frontmatter example_source_url = https://github.com/tw93/kami；README 第 490 行「模板来源」表同样映射 doc-kami-parchment ← tw93/kami，两处一致。
6结论
适合：适合严肃长文与正式文书：白皮书/研究报告 one-pager、投资备忘、信函、简历、changelog、财报摘要；适合需要印刷或 PDF 分发、想要「纸感」而非「网页感」的场合；适合有品牌克制审美的团队做统一文书模板。
不适合：不适合仪表盘/KPI 卡墙、营销落地页、需要多色与插图的产品页（会被禁止项压制）；不适合需要交互或动画的场景（禁脚本、禁阴影）；不适合彩色图表多的财报可视化（只允许单色 SVG 折线）；也不适合快速草稿场景——它的规则量决定了生成成本偏高。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 doc-kami-parchment.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent8d42d07c1757e428…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库nexu-io / nexu-io/html-anything
原始 GitHubnexu-io/html-anything ↗
Stars8827
最近推送2026-09-15
本 skill commit
553ed98c28许可Apache-2.0（仓库根 LICENSE = Apache License 2.0；GitHub API license.spdx_id = Apache-2.0；next/package.json 亦声明 Apache-2.0）
本站信息
收录日期2026-09-06
分类文档与知识
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。