1实现原理 · 为什么它能做到
这个 skill 不是可执行程序,而是「一个目录 = 一个模板」:SKILL.md 的 frontmatter 供选择器展示,正文(body)就是发给模型的提示词;加模板=加目录,不需要改 TypeScript。
routes rescan disk and the client refetches `/api/templates`.
实际下发提示词 = 平台共享设计指令(SHARED_DESIGN_DIRECTIVES)+ 本 skill 的 SKILL.md 正文 + 用户内容,由 assemblePrompt 拼成一条 prompt。
Wrap a per-template instruction body with the shared design directives and
成稿不走文件系统:共享指令明令禁止 Write/Edit/Bash 等文件工具,要求模型把整份 HTML 直接作为回复正文流式输出(stdout 由前端捕获落盘)。
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
交付物被定义为「3 分钟能拍板的一页」而非纪要/周报/PRD,并给出 9 段强制结构(memo header / decision needed / recommendation / why now / key facts / tradeoff table / risks / decision path / next actions)。
【意图】这不是会议纪要、不是周报、不是 PRD。它的唯一目标是帮助决策者在 3 分钟内理解问题并拍板。
首屏纪律写进设计要求:结论与建议必须最先出现,背景不得先行。
- 首屏必须直接呈现 decision + recommendation, 不要先铺陈背景。
本模板是 9 个里唯一自带可选风格资产目录的:assets/ 下三份可直接套用的 HTML 风格(board-memo 默认 / decision-command 深色指挥台 / board-paper 董事会纸议案),并规定按场景三选一、不得混用。
- `assets/board-memo.html`: 默认风格。浅色高管 memo, 适合 CEO/CFO/CRO、运营、产品决策。
样例成稿与 assets/board-memo.html 同源:目录里挂的 example.html 就是「默认风格」那份资产的实例化版本。
<div class="label">Tradeoff table</div>
内容真实性与证据缺口被写进规则:不许编造数字/客户/预算/日期;缺关键信息时列 Evidence gaps,但仍要给 provisional recommendation。
- 如果缺少关键信息, 在 Evidence gaps 中列出, 但仍给出基于现有证据的 provisional recommendation。
决策路径被产品化为三张并列卡(Approve / Reject / Need evidence),而不是一段「下一步」文字。
<h3 class="font-extrabold">Need evidence</h3>
服务端 /api/convert 只做三件事:按 templateId 从磁盘读 skill、拼 prompt、spawn 本地 agent CLI 并 SSE 流转发输出。
prompt = assemblePrompt({ body: skill.body, content, format });
2核心能力
4风险提醒 风险提醒:绿色 · 放心使用
- 结构与样例不完全对齐 — Why now / Next actions / Evidence gaps 在提示词里是强制的,但样例成稿没有对应区块;照样例复制会缺段,需以 SKILL.md 为准或人工补写。
- 版式依赖 Tailwind CDN — 三份资产大量使用 Tailwind 工具类,离线/内网打开会丢栅格与间距;正式分发(如董事会 PDF)前应先导出为自包含 HTML 或截图。
- 决策类内容的误导风险最高 — 一页 memo 的说服力容易让读者跳过证据核验;模板虽禁止编造,但 confidence level 与措辞仍可能被模型拔高,需人工复核关键数字来源。
- 敏感材料集中 — 输入常含未公开财务、客户、并购信息,成稿即为高敏文档;模板无脱敏与水印机制,需在流程上约束流转。
- README 未收录 — 仓库文档的模板表未列出本模板,外部读者可能不知道它存在(不影响 loader 加载)。
5第二遍独立确认
- [discrepancy] 9 段强制结构中样例实际覆盖的部分 — 样例含 Decision needed / Recommendation(含 Confidence: medium-high)/ Tradeoff table / Risks & mitigations / Decision path(Approve·Reject·Need evidence)/ header(Owner·Deadline·Audience);缺 Why now、独立 Key facts 块(仅 4 张指标卡)、Next actions、Evidence gaps。
- [ok] example.html 与 assets/board-memo.html 字节相同 — diff 输出为空;挂载的预览即默认风格资产的实例化版本。
- [ok] 三套风格资产存在且风格迥异 — board-memo(--paper:#faf9f5)、decision-command(--bg:#101418 深色)、board-paper(--paper:#fbfaf6 + Source Serif 4 + 双线 rule)三份齐全。
- [discrepancy] README 收录情况 — 仓库 README 的模板表(105 处模板链接)未列出 exec-briefing-memo,grep briefing/memo 只命中 deck-safety-alert;属文档滞后——目录存在、loader 能加载、featured=8 已声明。
- [ok] 成稿版式依赖 Tailwind 运行时 — 三份资产均 <script src="https://cdn.tailwindcss.com"></script> 且大量使用 Tailwind 工具类(p-7 / lg:grid-cols-[1.15fr_.85fr] 等);离线时栅格与间距会失效,仅内联 <style> 部分保留。
- [ok] 「不要捏造数字」与样例输入的关系 — example.md 提供了 18 inbound / 7 accounts / $18k-35k / 4-6w 等素材,样例成稿的 4 张指标卡(Enterprise asks 18、Large accounts 7、Potential ACV $18k-35k、Roadmap cost 4-6w)逐项对得上,未被编造。
- [ok] 目录内无脚本、无凭证读取 — 除 Tailwind CDN script 外无 JS;无 token/env 读取;assets 只被 SKILL.md 指定为风格参考,不执行。
6结论
69bd73088bbba9e0…553ed98c28