关于 improving-skills
用于改进现有 Agent 技能的流程,结合用户反馈与技术分析,并落实和验证修改。适合希望按步骤完善技能的作者。
主要功能
- 01收集用户反馈
- 02检查技能结构与实践规范
- 03制定优先级改进计划
- 04修改文件并验证结果
适用场景
- 01根据用户反馈优化技能
- 02排查触发、范围或输出问题
- 03修改并验证 SKILL.md 与参考文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ taisukeoe/ agentic-ai-skills-creator --skill improving-skills安装后在 Claude Code 中输入/improving-skills确认已加载。
附带文件tests/scenarios.md
详细介绍
改进 Skills
通过收集用户反馈和进行技术分析,改进现有的 Agent Skills。
工作流
步骤 1:确定目标 Skill
如果用户未提供路径,请询问 Skill 的路径(例如,.claude/skills/skill-name/)。
阅读 SKILL.md 并了解其当前结构。
步骤 2:收集反馈(必需)
询问关键问题:
“你希望改进这个 Skill 的哪些问题?”
根据用户的回答,按需提出后续问题:
| 如果用户提到…… | 后续问题 |
|---|---|
| 不满之处比较模糊 | “能否举一个它表现不佳的具体例子?” |
| 触发问题 | “它何时未能触发,或意外触发?” |
| 缺少功能 | “该功能正常工作时,你希望输出是什么样的?” |
| 输出过多或过少 | “你偏好什么详细程度?” |
| 范围不明确 | “这个 Skill 应该处理哪些任务,又不应该处理哪些任务?” |
尽量减少后续问题。通常一两个就够了。
步骤 3:技术分析
根据最佳实践进行检查(参考 reviewing-skills 的评审标准):
- 命名:使用动名词形式,且描述明确
- 描述:使用第三人称,包含做什么以及何时使用
- 大小:SKILL.md 少于 500 行
- 渐进式披露:将详细信息放在参考文件中
- 单一职责:目的明确且唯一
- 测试:存在 tests/scenarios.md(对于
/evaluating-skills-with-models为必需项)
步骤 4:提交改进计划
将改进分为:
用户要求的改进:
- 基于用户反馈
- 优先处理用户明确提到的内容
技术改进:
- 分析中发现的问题
- 仅包含影响较大的问题
格式:
## Improvement Plan
### User-requested
1. [Issue from feedback] → [Proposed fix]
### Technical
1. [Issue from analysis] → [Proposed fix]
Proceed with these changes?
步骤 5:实施
执行改进:
- 编辑 SKILL.md
- 按需更新或创建参考文件
- 适用时调整脚本或资源
展示所做更改的差异或摘要。
步骤 6:验证
快速检查:
- 更改解决了用户提出的问题
- 没有引入新问题
- Skill 仍遵循最佳实践
与 reviewing-skills 的主要区别
| reviewing-skills | improving-skills |
|---|---|
| 仅进行技术分析 | 用户反馈 + 技术分析 |
| 提供反馈 | 实施更改 |
| 只读 | 可读写 |
评论
支持 Markdown