技能优化指南

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

触发条件

用户要求优化某个技能包的文档结构、精简行数 SKILL.md 超过 200 行,需要瘦身 多个章节存在重复内容,需要合并或抽取 完整代码块需要迁移到 references 或 samples 用户提到"技能优化"、"SKILL 瘦身"、"文档精简"

严格边界

本技能只修改文档结构,不修改技能的业务逻辑 抽取内容到 references 时,必须同步在 SKILL.md 中添加引用链接 不得删除信息,只能迁移——SKILL.md 删除的内容必须在 references 中保留 修改前必须先读取目标文件确认内容,避免破坏已有结构

优化目标

维度 · 目标 · 衡量标准 精简度 · SKILL.md ≤ 200 行 · 大模型单次读取不超载 自包含 · 入口文件回答"怎么做"和"什么规则" · 不需跳转即可开始开发 零冗余 · 同一信息只在一个地方详细展开 · 任意两文件重叠率 ≤ 15% 可验证 · 规则数、规则内容、代码示例三者对齐 · 模拟阅读零矛盾

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@openyida · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
Step 1:现状评估

统计目标 SKILL.md 行数(`wc -l`) 识别重复章节——以下模式是合并信号: "核心约束" + "严格禁止" + "严格要求" + "编码注意事项" → 合并为"核心规则" 同一规则在多个章节出现 → 只保留一处 检查与 references 的内容重叠:

02
Step 2:执行优化

按优先级处理: 删除完整代码块:替换为 `openyida sample` 命令引用或 references 链接 合并重复章节:多个约束/规则章节合并为统一的"核心规则" 抽取详细内容:JSON Schema、Prompt 模板、字段类型表等 → `references/*.md` 补全引用链接:每处抽取都必须在原位添加 `> 📖 详见 [references/xxx.md]` 引用

03
Step 3:验证

确认行数 ≤ 200 确认所有 references 链接路径正确 确认无信息丢失(抽取的内容在 references 中完整保留)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。