Skill Writer 适用场景 - 新建项目级或个人级 skill - 压缩过长的 - 将百科式文档拆成 - 重写 ，提升 skill 路由命中率 - 统一一批 skill 的结构、命名和风格 不适用场景 - 只是补一两行普通说明，不涉及 skill 结构调整 - 只是新增业务知识，但不需要形成可复用 skill - 用户要修改的是 rule、hook、普通文档，而不是 skill 快速指导 1. 先确定 skill 的单一职责。一个 skill 只解决一类问题，不要把总览、教程、百科和脚本说明混在一起。 2. 把 当成路由触发器，而不是功能简介。优先写“用户在什么场景下会需要它”。 3. 主 只保留高信号内容： - 适用场景 - 不适用场景 - 快速指导 - 高信号规则 - 关键陷阱 - 延伸阅读入口 4. 默认假设模型已经知道通用常识。只保留项目特有约定、容易出错的边界、历史坑点和明确偏好。 5. 主 的目标不是“尽量短”，而是“短到只剩路由和行动指导”。在当前仓库里，主文件通常应收紧到约 行。 6. 重内容放到 ： - 大段背景知识 - 长表格 - 代码目录 - 完整案例 - FAQ - payload 示例 - 状态枚举 - 确认模板 7. 只有在流程高度确定、稳定且容易出错时，才把逻辑下沉到 或模板文件。 8. 所有链接尽量保持一层深度，避免主 skill 还要继续…