writing-skills

Writing Skills - 智能体技能创建指南

技能概述

Writing Skills 是智能体技能创建的调度中心，提供决策树、模板和标准，帮助开发者创建、更新或优化 AI 智能体技能。

适用场景

创建新技能 - 根据技能复杂度选择合适的架构模板（Tier 1-3），从简单单文件技能到大型平台级技能

优化现有技能 - 解决技能被 AI 忽略、用户无法发现、描述不触发等问题，使用 CSO 搜索优化和反合理化技术

技能合规验证 - 检查元数据配置、命名规范、目录结构，确保技能符合编写标准

核心功能

决策树导航

通过快速决策树确定正确的工作路径：新建技能选择 Tier 1-3 架构，现有技能进行模块化或 CSO 优化，合规性检查使用标准文档。

技能模板库

提供四种技能模板：技术型（操作指南）、参考型（文档）、纪律型（规则）和模式型（设计模式），每种模板都有标准结构和最佳实践。

CSO 搜索优化

"针对大语言模型的 SEO"，指导如何编写技能描述和触发关键词，确保技能能够被正确发现和触发。

常见问题

如何选择技能架构模板？

根据复杂度选择：简单单文件技能（<200 行）使用 Tier 1 架构；多概念复杂技能（200-1000 行）使用 Tier 2 扩展架构；大型平台（10+ 产品）使用 Tier 3 平台架构。

技能描述为什么不触发？

检查描述是否以 "Use when..." 开头，是否包含具体的触发关键词，metadata.triggers 字段是否有 3+ 个关键词。使用 CSO（搜索优化）指南改进描述写作。

SKILL.md 文件应该放在哪里？

技能目录下必须放置全大写的 SKILL.md 文件，复杂技能可以在 references/ 目录下放置补充文档。文件名必须与技能目录的 name 字段完全匹配。