skill-author
当用户想创建一个新技能时使用——用户描述想要的能力（说"帮我写个技能/创建一个 skill/生成 SKILL.md/做个 XX 技能"），本技能引导生成规范的 SKILL.md（name、description、正文指令）。若要交付成可上传插件包，可继续按「插件包标准化」规则补 plugin.json/图标、导出标准包，最后询问用户是否安装。
git clone --depth 1 https://github.com/Pinvou/pinvou-agent /tmp/skill-author && cp -r /tmp/skill-author/pinvou3-app/src-tauri/resources/common/skill-marketplace/skill-author ~/.claude/skills/skill-authorSKILL.md
# 技能创建（skill-author）
把用户的一句描述，变成一个可用的**技能**（`SKILL.md` 目录）。规范与「插件包标准化」
（package-author）同源；本技能只管「从描述到 SKILL.md」，打包交给 package-author 的规则。
## 何时用 / 何时不用
- ✅ 用：用户说"写个技能 / 创建 skill / 生成 SKILL.md / 做个 XX 技能"，或描述了一个
想要的能力但还没有技能文件。
- ❌ 不用：用户已有技能文件、只是要打包/标准化 → 走「插件包标准化」；或只是写普通
脚本/网页（非技能）；或要装/卸/开关某个已存在的工具。
## 先问清（问清再动手，别猜）
1. **技能做什么**：一句话说清能力边界（不要贪多，一个技能干一件事）。
2. **何时触发**：用户在什么场景/说什么话时该用这个技能？
3. **现成素材**：有没有要一起打包的脚本、命令、资料、模板？
4. **命名**：技能名（英文 kebab-case，语义化小写，如 `git-commit-helper`）。
用户没给全时，先补问；用户说"你看着办"才自行定，并在产出里说明可改。
## 生成 SKILL.md
frontmatter（必填两项）：
```markdown
---
name: <name> # [a-zA-Z0-9_-]{1,64}，语义化小写 kebab-case
description: <做什么 + 何时用> # 模型触发它的依据，一句话写清楚
---
```
正文（给模型看的指令），按需包含：
- **目标**：这个技能要达成什么。
- **步骤/流程**：明确、可执行的步骤（1/2/3…）。
- **红线**：绝不能做的事（编造 ID/凭据、越界调用等）。
- **示例**：一两个典型输入→输出。
硬规则：
- `name` 全 ASCII 小写 kebab-case，禁 `.`/`..`/路径分隔符/空格/大写（与导入校验一致）。
- `description` 必须讲清「做什么 + 何时用」，别只写"一个有用的技能"。
- 参考资料放 `references/*.md`，正文只列目录（渐进披露）；别把大段内容全塞进正文。
- 技能要**自包含**：指令里写清依赖、前置条件、失败处理。
落盘：写 `skills/<name>/SKILL.md`（相对工作目录），并列出文件清单。
## 可选：导出标准包（结合「插件包标准化」）
用户要"能上传/能安装/给我一个包"时，按 package-author 的规则补齐：
1. 目录：`<id>/skills/<name>/SKILL.md`（+ 可选 `references/`）。
2. `plugin.json`：`manifest_version:1`、`id` 全小写、`components.skills:[{id:<name>, dir:"skills/<name>"}]`。
3. 图标：生成一个简约 `icon.svg`（24×24 几何、`stroke="currentColor"`、无外链/脚本）。
4. 校验命名与布局 → 产出 `<id>/` 目录或 `<id>.zip`（zip 根就是 `plugin.json`，别多套一层）。
## 收尾：询问是否安装
- 生成（或导出）完成后，**主动问用户**："已生成 XXX 技能，要安装吗？"
- 说明安装方式：把 `<id>.zip` 拖进插件中心上传，或到商店「技能」区点安装。
- **不要擅自安装/上传**，等用户确认；用户说"装"再给下一步指引。
## 校验清单（交活前逐条过）
1. SKILL.md frontmatter 有 `name` + `description`，`name` 合法小写 kebab-case。
2. 正文有可执行步骤 + 红线（若有）。
3. （若导出）`plugin.json` 齐、目录布局对、有 `icon.svg`。
4. 已询问用户是否安装，未擅自操作。直出好看的网页/落地页/banner/海报/产品介绍页/数据报告/简历/作品集等视觉物料——套一套设计系统，模型自由写自包含 HTML，颜值由规则锁死、不靠模板。用户说"做个网页/页面/落地页/banner/海报/报告页/作品集/简历"或"把这份内容做成网页版"时使用。⚠️ 不含信息检索：查天气/查行情/查股价/查数据请走对应连接器，不是本技能。
【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限；遇到 Base/多维表格/bitable、BaseApp/AppMode 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入转 lark-drive，认证/授权转 lark-shared。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书日历:管理日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。不负责:查询视频会议记录(本 skill 只覆盖日程;lark-vc 技能未随包收录,可 CLI 直连,见意图路由)、待办任务(走 lark-task)。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云文档(Docx/Wiki)与思维笔记内容操作:读取、创建、编辑文档,插入或下载图片附件,查询或回滚历史版本。用户给出文档 URL/token(含 doubao.com 的 /docx/、/wiki/)时使用,按 URL 路径/token 而非域名路由;内嵌表格、多维表格、画板先提取 token 再切对应 skill。文档评论走 lark-drive;表格或 Base 内部数据操作不在本 skill。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退 WebFetch。不负责:文档内容编辑(lark-doc)、表格/Base 表内数据(lark-sheets/lark-base)、知识库节点(lark-wiki)。
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）与卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索或创建群聊/话题群、管理标记数据、Feed 置顶与标签数据、处理卡片回调时使用。
【何时用:仅在其他 lark-* 技能遇到认证/授权/身份/配置问题时,或首次使用 lark-cli 时;泛指需求默认走本地工具】lark-cli 共享规则:首次配置(config init)、认证登录(auth login --domain/--scope,split-flow)、登录态查询与撤销(auth status/logout/whoami)、--as user/bot 身份切换、权限不足与 missing_scope 处理、JSON 输出契约与 _notice、update 更新、高风险操作审批(exit 10)。