用途
Skill Template Generator 用于把结构化模式描述转换为可被 OpenSpace 注册、选择并演化的 SKILL.md 技能文件。输入可以来自 codebase-pattern-analyzer，也可以来自人工分析。
适用时机包括：从参考代码库提取模式后，需要将其打包为可复用技能；需要创建新技能，指导智能体完成某类任务；将非正式文档或代码示例转换为 SKILL.md 格式。
目录与格式
每个技能对应一个目录，至少包含 SKILL.md：
my-skill-name/ ├── SKILL.md # 必需，技能定义 ├── scripts/ # 可选，辅助脚本 ├── references/ # 可选，参考数据文件 └── assets/ # 可选，图像、模板
文件必须以 YAML frontmatter 开头，且只包含两个字段：
name: my-skill-name description: 用一句话说明该技能教什么，需足够具体，便于 LLM 技能选择时匹配相关任务。
规则：name 必须与目录名一致（kebab-case、小写）；description 建议 15–40 个单词，包含 LLM 可能搜索的关键词；不添加其他 frontmatter 字段，其余内容放入 markdown 正文。
正文模板如下：
[技能标题]
[用 1–2 句话说明该技能能做什么]
When to Use
- [触发条件 1]
- [触发条件 2]
- [触发条件 3]
[核心内容章节]
[分步说明、代码模板、API 参考等]
Key Patterns
- [约定或最佳实践 1]
- [约定或最佳实践 2] ...
生成步骤
第 1 步：确定技能分类。将技能模式匹配到 OpenSpace 三类之一：tool_guide（教如何使用特定工具或技术）、workflow（规定有序的端到端流程）、reference（提供用于决策的知识）。分类会影响 OpenSpace 在执行分析中的判断方式：workflow 关注智能体是否遵循既定步骤，tool_guide 关注是否使用所述工具或方法，reference 关注知识是否影响智能体决策。
第 2 步：撰写描述。description 是最关键的一行，决定 OpenSpace 是否选择该技能。推荐公式为：[动作动词] + [具体主题] + [关键技术或方法] + [上下文或项目引用]。应具体、可搜索，避免宽泛描述。
第 3 步：编写可执行说明。正文要具体到智能体无需猜测即可执行。workflow 类技能应包含精确文件路径、完整可运行代码块、所需 import、接口定义和集成点，并使用 {baseDir} 表示相对技能目录的路径。tool_guide 类技能应包含 API 端点及参数、认证方式、响应结构、速率限制和错误处理。reference 类技能应包含结构化索引、关键文件路径、架构决策原因和方案对比表。
第 4 步：添加依赖提示。若技能依赖其他技能的模式，应在 Prerequisites 中明确列出，以便 OpenSpace 在派生新技能时理解技能组合关系。
第 5 步：校验技能。保存前检查：frontmatter 为有效 YAML（无制表符、缩进正确、特殊字符加引号）；name 与目录一致；代码块完整可复制运行；无失效引用；描述足够具体。
演化机制
生成的技能设计为可演化：FIX 表示 API 或代码模式失效时，OpenSpace 就地更新技能；DERIVED 表示新面板需要类似服务时，OpenSpace 派生专门版本；CAPTURED 表示智能体执行中发现新模式时，OpenSpace 将其捕获为新技能。初始技能质量越高，后续演化出的技能质量越好。
限制
资料未提供收费、价格、平台支持范围或具体使用限制信息。