article-prompts-to-skills

将文章提示词提取为技能

将源提示词转化为小型、可演示的能力包。保留实用行为，而非源页面的品牌或布局。

1. 提取前先检查

1. 阅读仓库说明和完整源文章。
2. 运行 git status --short；保留无关改动。
3. 列出每条明确的提示词、标题、示例、资源和验收标准。
4. 创建文件夹前，搜索现有的 SKILL.md 文件，检查是否有重叠能力。
5. 如果源内容是原始 HTML，且提示词尚不存在，请先使用 $html-to-interaction-prompts，然后返回此处。

不要仅凭标题推断一组技能。每项拟议技能都必须有源内容作为依据。

2. 创建提取台账

编辑文件前，先创建一张工作表：

源提示词	可复用能力	保留	移除	技能名称	演示证明

遵循以下边界：

• 每种可独立复用的行为创建一项技能。
• 只有在拆开后会导致任一步骤无法使用时，才合并步骤。
• 如果现有技能的约定已涵盖该能力，则更新现有技能。
• 跳过无法形成可重复方法的装饰性或编辑性片段。
• 技能名称应描述结果或机制，绝不能以源文章命名。

3. 提取可移植的约定

保留源内容中有效的机制：

• 行为和状态转换；
• 数据模型和参数默认值；
• 时序、缓动、间距和响应式规则；
• 无障碍支持、减少动态效果和键盘行为；
• 性能限制和故障模式；
• 用于证明结果的验收检查。

移除源内容特有的包装：

• 品牌名称、营销文案和专有内容；
• 与该能力无关的页面布局；
• 硬编码的配色方案、资源和选择器；
• 不影响结果的偶然实现方式。

所得内容必须能迁移到不同的主题、布局和视觉系统，无需重写核心说明。

4. 封装每项技能

使用已安装的 skill-creator 初始化器初始化每个新文件夹，然后完成以下约定：

agent-skills/<category>/<skill-name>/
  SKILL.md
  agents/openai.yaml
  references/          # only when detailed reusable guidance is needed
  assets/ or scripts/  # only when the workflow genuinely reuses them
  demo/
    index.html
    PROMPT.md
    preview.jpg
    input.md            # required for workflow skills
    expected-output.md  # required for workflow skills

以祈使句形式编写 SKILL.md。frontmatter 中只保留 name 和 description。将所有触发短语放在 description 中。将操作步骤、限制、陷阱和验证命令放在正文中。

根据最终技能编写 agents/openai.yaml：

• 使用易于理解的显示名称；
• 简短描述长度为 25 至 64 个字符；
• 默认提示词必须明确调用 $skill-name。

5. 编写三个实用的示例提示词

在 demo/PROMPT.md 中使用以下标题：

最简提示词

调用技能，并提出一个明确的目标。

Use $skill-name to add <capability> to <target>.

重现演示

描述参考体验、实现约定、交付内容和验收检查。明确指出哪些内容必须保持本地且独立。

改编提示词

更改主题、内容、配色方案和构图，同时保留机制、无障碍行为、响应式规则和性能约定。

阅读 references/example-packages.md，了解视觉类、混合来源和工作流示例。

6. 构建可验证的成果，而非装饰

确保每个演示都原创、独立且可检查：

• 在首屏展示核心机制；
• 使用真实内容，避免使用“演示卡片”等标签；
• 仅在控件能展示有意义的状态时添加控件；
• 支持 390px 至 1440px 的布局；
• 使用语义化 HTML 和清晰可见的焦点状态；
• 为动画内容提供减少动态效果的行为；
• 保持依赖项为本地依赖，除非技能要求，否则不使用构建步骤；
• 对非视觉工作流使用 input.md 和 expected-output.md。

绝不能把截图当作实现。HTML 演示必须能够正常运行。

7. 验证完整的软件包

根据产物的规模执行相应验证：

1. 对每个新建或修改的技能运行技能创建器的 quick_validate.py。
2. 运行仓库演示验证和所有针对性的语法检查。
3. 在允许使用的浏览器中，以桌面和移动设备尺寸打开每个演示。
4. 测试主要交互、键盘焦点和减少动态效果路径。
5. 确认控制台没有问题。
6. 按照仓库共享尺寸，截取真实的浏览器预览。
7. 重新构建演示和截图图库，然后再次验证。
8. 扫描已更改的文件，检查其中是否包含密钥、令牌、私有路径和私有客户端数据。

仅凭静态文件检查，不得声称已完成视觉或交互验证。

8. 仅提交本任务相关内容

暂存新建的技能文件夹及其所需的图库文件。提交前查看 git diff --cached --stat 和 git diff --cached。保留预先存在的脏文件，不要改动。

请报告：

• 源内容到技能的映射；
• 示例提示词和演示路径；
• 验证结果和浏览器证据；
• 提交哈希；
• 提交之外仍保留的无关脏文件。

失败模式

• 页面克隆： 复制源布局，而不是提取其机制。
• 巨型技能： 将彼此独立的提示词合并成一个含糊的技能。
• 微小片段： 把每句话都拆成技能，缺少可复用行为。
• 主题锁定： 将源内容的配色、素材或文案硬编码。
• 仅含提示词的软件包： 未提供可运行的演示和预览。
• 虚假证明： 未实际测试交互，却声称已验证。
• 脏工作区外溢： 将无关修改或生成文件暂存。