组件文档编写 Skill 介绍：让智能体按固定流程完成任务
如果你在浏览器、组件库与设计稿里反复做组件文档编写，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。
一句话说明
「组件文档编写」技能让智能体为组件编写 Storybook 示例与说明。你提供组件代码，它按固定步骤处理，交付示例文件。
| 项目 | 说明 |
|---|---|
| 技能 | 组件文档编写（storybook-writer） |
| 作用 | 为组件编写 Storybook 示例与说明 |
| 输入 | 组件代码 |
| 输出 | 示例文件 |
| 形态 | 纯提示词 |
| 风险 | 低 |
| 适用人群 | 前端工程师 |
它解决什么问题
没有技能时，前端工程师每次都要重新描述要求，智能体的输出时详时略、格式不一，关键的检查步骤也经常被跳过。把流程写成技能后：
- 每次都按同样的顺序执行：列出组件状态→为每个状态写示例→补充参数说明→检查渲染
- 输出结构固定，便于复核和归档
- 领域规矩（如「视觉与交互结果要在真实浏览器里确认」）写在技能里，不靠临时提醒
适合与不适合
适合：经常处理组件代码、希望结果格式统一、愿意花十分钟把流程写清楚的前端工程师。
不适合：一次性的临时任务；需要大量现场判断、无法写成步骤的工作；以及没有人复核就要直接对外使用的场景。
可以在哪些平台实现
同一个技能的思路可以落在不同平台上，常见选择有：
- Windsurf Rules：Windsurf 的规则用于约束 Cascade 智能体的行为
- OpenAI Agents SDK：OpenAI Agents SDK 是一个轻量的智能体开发框架
- n8n AI Agent：n8n 是可自托管的工作流自动化工具
- Claude Code Skill：Claude Code 的 Agent Skills 以文件夹为单位：一个 SKILL.md（YAML 头写 name 与 description）加上可选的脚本和参考资料。智能体平时只看到 description
怎么开始
建议先用纯提示词版本在日常对话助手里试几次，确认步骤合理；再按SKILL.md 写法封装成技能；最后用测试用例验收。
这个技能纯指令型，不需要额外脚本或外部连接，复制到大多数平台都能用；风险较低，但输出仍需快速过目再使用。
常见变体
同一个技能可以按使用场景派生出几个变体：
- 简版：只保留核心步骤（列出组件状态、检查渲染），适合快速过一遍
- 详版：每一步都写出理由与依据，适合交给他人复核或留档
- 批量版：一次处理多份组件代码，输出汇总表，适合定期集中处理
变体之间共享同一套约束，只在步骤详略和输出格式上有差异。可以在一个技能里用参数区分，也可以拆成几个名称明确的技能。
什么时候用这个技能
- 手头有组件代码，需要在较短时间内得到示例文件
- 同类任务每周出现多次，希望每次处理方式一致
- 结果要交给同事或上级复核，需要统一的结构和清楚的依据
- 新人接手这类工作，需要一个可以照着做的标准流程
反过来，如果只是偶尔做一次，或者任务高度依赖现场判断，直接和浏览器、组件库与设计稿里的智能体对话即可，不必专门封装成技能。
延伸阅读
- 组件文档编写 · GitHub Copilot 指令与提示文件 版
- 组件文档编写 · OpenAI Agents SDK 版
- 组件文档编写 · GPTs 版
- 深色模式适配 · 介绍
- 接口调用层生成 · 介绍
- 智能体Skills 分类：625 个技能 × 32 个角度
说明：文中的配置、代码与目录结构均为示意，用于说明思路；各平台的入口、字段名与能力会更新，落地前请以对应官方文档为准。示例中的数据与场景为虚构，不代表真实案例。