메뉴
为 Pi 扩展（插件）制作一页展示卡片（HTML），用 kami one-pager 模板。流程：读代码理解插件 → 读文章找定位 → 讨论布局 → 用 kami 出卡 → 反复调内容。必须使用此技能的场景：用户说「做一张展示卡」「做个介绍页」「出一页卡片」「写一个插件宣传页」「做个演示卡」「插件展示」「presentation card」，或完成了某个插件后需要一张介绍卡片。也适用于非 Pi 插件的工具/库/项目，只要用户想做一页介绍。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
审查 Agent 入口——加载变更上下文，对照 plan/tasks/code 审查产物，输出审查结论
AI 开发工作流全景——流水线顺序、技能关系、使用指南。受 Matt Pocock skills 启发。
纯追问理清任何想法，不绑定变更，不写文件
逐条追问澄清变更范围和用语，对照项目文档消除歧义
压缩当前对话为交接文档，供下一个会话继续
扫描代码库发现架构改进机会，产出列表供选择
| name | plugin-presentation-card |
| description | 为 Pi 扩展（插件）制作一页展示卡片（HTML），用 kami one-pager 模板。流程：读代码理解插件 → 读文章找定位 → 讨论布局 → 用 kami 出卡 → 反复调内容。必须使用此技能的场景：用户说「做一张展示卡」「做个介绍页」「出一页卡片」「写一个插件宣传页」「做个演示卡」「插件展示」「presentation card」，或完成了某个插件后需要一张介绍卡片。也适用于非 Pi 插件的工具/库/项目，只要用户想做一页介绍。 |
| when_to_use | 插件展示卡, 一页介绍卡, 插件宣传页, presentation card, 演示卡, 介绍页, one-pager, 产品卡, 工具介绍卡 |
用 kami 的 one-pager 模板，为 Pi 扩展（或其他工具）制作一页 A4 展示卡片。这张卡用于文章插图、演示现场投影、社交媒体分享等场景。
每个模块只保留最核心的信息。导语能一句话说完就别写三段——下面已经展开解释了。用户会抠字眼，每一句都要经得起推敲。
痛点 vs 解法、旧方式 vs 新方式、处理前 vs 处理后。同屏对比比逐条说明更有视觉冲击力。在布局中刻意制造这种「左右对照」的结构。
好的卡片有一条隐形的叙事线：问题 → 解法 → 体验 → 架构 → 安装。每个板块承上启下，不是功能列表堆砌。
一张好的 TUI/UI 截图抵得上一百字描述。截图的尺寸、位置、配文直接影响页面重心。两张图并排对比时必须统一尺寸，否则视觉上歪一边。
不要一次做完所有内容再给用户看。先用文字草图（ASCII 或描述）和用户对清楚布局，再填充模板。改结构比改措辞代价大得多。
加载 kami skill，让它执行自己的前置检查（品牌配置、更新检查等）。
先读插件的代码和 README，搞清：
输出：在心中形成 3-5 个关键信息点。
如果卡片是为某篇文章做的配图/插图，一定要先读那篇文章或章节。目的是：
在填模板之前，用 ASCII 草图向用户展示你的布局方案。讨论维度：
| 维度 | 决策点 |
|---|---|
| 受众 | Pi 开发者 / AI 工具用户 / 技术分享听众 |
| 叙事角度 | 问题→方案对比 / 技术深度 / 功能亮点 |
| 代码示例 | 是否需要？并排对比还是单示例？谁来截图？ |
| 截图 | 几张？截什么内容？并排还是上下？ |
| 输出格式 | HTML+PDF / PNG / 仅 HTML |
建议用这个格式展示布局（替换实际内容）：
┌── HEADER ────────────────────────────────────┐
│ ⬛ 标签 │
│ # 标题 │
│ 副标题 │
│ 作者 · 日期 · 版本 │
├── LEAD ──────────────────────────────────────┤
│ 一句话痛点定调 │
├── TWO-COL ───────────────────────────────────┤
│ 左: 痛点 │ 右: 解法 │
├── 体验/亮点 ──────────────────────────────────┤
│ ... │
├── 截图对比 ───────────────────────────────────┤
│ [图A] [图B] │
├── 架构/扩展面 ────────────────────────────────┤
│ 表格/列表 │
├── 安装 ──────────────────────────────────────┤
│ ⚡ pi install ... │
└── FOOTER ────────────────────────────────────┘
布局确认后，拷贝 kami one-pager 模板：
cp <kami-skill-dir>/assets/templates/one-pager.html <output-dir>/<card-name>.html
填充规则：
<body> 内内容，CSS 不动<meta> 占位符（title/author/description/keywords）{{...}} 占位符Header：
Lead（导语）：
两栏痛点 vs 解法：
双通道/体验（如果适用）：
截图：
.two-col 布局做并排对比，上方加 h2 标题data:image/jpeg;base64,... 转 base64扩展面/架构（可选）：
table.compact 做两列表格：扩展面名称 | 在插件中的作用安装：
.callout + span.hl 展示安装命令Footer：
内容填完后，用户会提修改意见。常见修改类型：
修改策略：
src 属性。验证没有残留的文件引用（grep -F 检查文件名是否还在 HTML 里）。docs/presentation-cards/ 目录存在，把 HTML 文件移入。如果需要放到别的路径，先问用户。ls -lh 查看文件大小，确认单文件自包含、浏览器可打开。目前只用 kami 的 one-pager 模板。未来如果出现其他场景：
long-doc 模板slides-weasy 模板以下文件按需读取，不要一次性全加载：
| 场景 | 读取 |
|---|---|
| 首次制作新卡 | CHEATSHEET.md + one-pager.html 模板 |
| 调整布局/间距 | 模板 HTML（CSS 只读）+ CHEATSHEET.md |
| 添加 SVG 图表 | references/diagrams.md |
| 质检 | references/anti-patterns.md |
直接加载 kami skill，由它管理自己的文件和路径。