技能书 Skillbook

什么是技能书

技能书就是一份带 frontmatter 的 SKILL.md，放在 opencode 约定的技能目录里；AI 在会话中能看到技能书清单与描述，需要时按 name 加载整本内容进上下文。它不是文档站的 CSS / JS 依赖，不会自动执行，只按需拉取。

位置	作用范围
~/.config/opencode/skills/<name>/SKILL.md（Windows：%USERPROFILE%\.config\opencode\skills\）	全局，本机所有项目可用
.opencode/skills/<name>/SKILL.md	项目级，仅所在仓库可用

frontmatter 字段要求：

字段	必填	要求
name	是	1–64 字符，格式 ^[a-z0-9]+(-[a-z0-9]+)*$，且与所在目录同名
description	是	1–1024 字符，写清「何时使用」——AI 路由到该技能书的唯一依据
license	否	许可证标识（如 MIT）

当前技能书 · kuoqiui

技能书	文件	加载时机	内容概要
kuoqiui	skills/kuoqiui/SKILL.md	涉及 KuoqiUI 组件 / 样式 / 表单引擎 / 文档站改动前	基类+变体机制、设计系统变量、工具类速查、syncForm 32 控件、docs/ 工作流与回归流程

加载方式

自然语言直接说「加载 kuoqiui 技能书」，或让 AI 调用 skill 工具按 name 拉取：

新增与维护规范

技能书目录总索引见 skills/README.md；新增一本技能书按以下流程：

步骤	要求
1. 建目录与文件	skills/<name>/SKILL.md，目录名 = name，格式 ^[a-z0-9]+(-[a-z0-9]+)*$
2. 写 frontmatter	必填 name / description（1–1024 字符），可选 license
3. 三处同步登记	kuoqi-skillbook 菜单清单、skills/README.md 总索引、本页（docs/skills.html）
4. 写内容	写「何时使用」、项目约定、速查表与常见坑；宁引用框架类，不重复造轮子