Agent助手
- 作者仓库星标 175
- 作者更新于 实时读取
- 作者仓库 openyida
- 领域
- 通用
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @openyida · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: skill-optimization-guide
description: 技能文档(SKILL.md)优化指南。当用户要优化某个技能包的 SKILL.md 文档结构、精简行数、消除冗余、抽取 references 时触发。适用于技能包超过 200 行需要瘦身、多章节…
category: 通用
runtime: 无特殊运行时
---
# skill-optimization-guide 输出预览
## PART A: 任务判断
- 适用问题:通用任务拆解、检查和交付。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“触发条件 / 严格边界 / 优化目标”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于通用任务拆解、检查和交付,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“触发条件 / 严格边界 / 优化目标”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 先确认触发方式
原文没有稳定的斜杠命令要求。安装验证后通常全局生效,直接在对话里点名这个 Skill 并描述任务即可。
给清楚输入和边界
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件。
小样例验证后再放大
先用一个小任务确认它会围绕“触发条件 / 严格边界 / 优化目标”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
复核后再交付
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: skill-optimization-guide
description: 技能文档(SKILL.md)优化指南。当用户要优化某个技能包的 SKILL.md 文档结构、精简行数、消除冗余、抽取 references 时触发。适用于技能包超过 200 行需要瘦身、多章节…
category: 通用
source: openyida/openyida
---
# skill-optimization-guide
## 什么时候使用
- 把通用方向的常用动作沉淀成 Agent 可调用的技能 适合处理通用任务拆解、检查、交付和复盘,核心价值是把输入、判断、执行、验证和交付边界固定下来,避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤;通常不需要额外…
- 面向通用任务拆解、检查和交付,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「触发条件 / 严格边界 / 优化目标」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 证据边界与执行链路
作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "skill-optimization-guide" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> 触发条件 / 严格边界 / 优化目标
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} 技能文档优化指南
对技能包的 SKILL.md 进行结构优化,使其符合"导航枢纽"定位:精简、自包含、零冗余。
触发条件
- 用户要求优化某个技能包的文档结构、精简行数
- SKILL.md 超过 200 行,需要瘦身
- 多个章节存在重复内容,需要合并或抽取
- 完整代码块需要迁移到 references 或 samples
- 用户提到"技能优化"、"SKILL 瘦身"、"文档精简"
不适用场景(不要触发):
- 技能包的功能开发或 bug 修复 → 直接编辑对应文件
- 静态诊断评分 →
skill-static-diagnosis - 运行时测试、接口联调 → 不在本技能范围
严格边界
- 本技能只修改文档结构,不修改技能的业务逻辑
- 抽取内容到 references 时,必须同步在 SKILL.md 中添加引用链接
- 不得删除信息,只能迁移——SKILL.md 删除的内容必须在 references 中保留
- 修改前必须先读取目标文件确认内容,避免破坏已有结构
优化目标
| 维度 | 目标 | 衡量标准 |
|---|---|---|
| 精简度 | SKILL.md ≤ 200 行 | 大模型单次读取不超载 |
| 自包含 | 入口文件回答"怎么做"和"什么规则" | 不需跳转即可开始开发 |
| 零冗余 | 同一信息只在一个地方详细展开 | 任意两文件重叠率 ≤ 15% |
| 可验证 | 规则数、规则内容、代码示例三者对齐 | 模拟阅读零矛盾 |
执行步骤
Step 1:现状评估
- 统计目标 SKILL.md 行数(
wc -l) - 识别重复章节——以下模式是合并信号:
- "核心约束" + "严格禁止" + "严格要求" + "编码注意事项" → 合并为"核心规则"
- 同一规则在多个章节出现 → 只保留一处
- 检查与 references 的内容重叠:
- SKILL.md 有完整代码示例 → 移到 references 或 samples
- SKILL.md 有详细规范解释 → 移到 references,SKILL.md 只留摘要+引用
Step 2:执行优化
按优先级处理:
- 删除完整代码块:替换为
openyida sample命令引用或 references 链接 - 合并重复章节:多个约束/规则章节合并为统一的"核心规则"
- 抽取详细内容:JSON Schema、Prompt 模板、字段类型表等 →
references/*.md - 补全引用链接:每处抽取都必须在原位添加
> 📖 详见 [references/xxx.md]引用
Step 3:验证
- 确认行数 ≤ 200
- 确认所有 references 链接路径正确
- 确认无信息丢失(抽取的内容在 references 中完整保留)
异常处理
| 异常场景 | 处理方式 |
|---|---|
| SKILL.md 已经 ≤ 200 行 | 告知用户无需优化,或仅做结构微调 |
| 无法判断哪些内容应抽取 | 优先抽取完整代码块和 JSON 示例,保留流程步骤和规则摘要 |
| references 目录不存在 | 先创建 references/ 目录再写入文件 |
| 抽取后 SKILL.md 仍超 200 行 | 进一步合并重复章节,或将使用示例也抽取到 references/examples.md |
SKILL.md 的导航枢纽原则
SKILL.md 是导航枢纽,不是内容倾倒场:
| 内容类型 | SKILL.md 中保留 | 详细内容放在 |
|---|---|---|
| 规则 | 名称 + 一句话描述 | references/*.md |
| 代码 | openyida sample 命令 |
samples/*.js |
| API | 速查表(方法名+说明+必填参数) | yida-api.md |
| 流程 | 完整保留(bash 步骤) | — |
| JSON Schema | 引用链接 | references/*.md |
| Prompt 模板 | 引用链接 | references/*.md |
完成检查清单
- SKILL.md ≤ 200 行
- SKILL.md 无完整代码块(只有 bash 命令和速查表)
- 所有抽取内容在 references 中完整保留
- 所有引用链接路径正确可达
- 参考文档导航表完整(含跨 skill 共享文档)
参考文档
| 文档 | 覆盖范围 | 何时阅读 |
|---|---|---|
| 优化方法论 | 三层职责模型、规则分级标准、代码去重规范、验证方法、反模式案例 | 首次执行优化前必读 |
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核