mcpField
I
improving-skills

improving-skills

github.com/taisukeoeAgent 工作流342 次安装40 周前更新
代码仓库

关于 improving-skills

用于改进现有 Agent 技能的流程,结合用户反馈与技术分析,并落实和验证修改。适合希望按步骤完善技能的作者。

主要功能

  1. 01收集用户反馈
  2. 02检查技能结构与实践规范
  3. 03制定优先级改进计划
  4. 04修改文件并验证结果

适用场景

  1. 01根据用户反馈优化技能
  2. 02排查触发、范围或输出问题
  3. 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:实施

执行改进:

  1. 编辑 SKILL.md
  2. 按需更新或创建参考文件
  3. 适用时调整脚本或资源

展示所做更改的差异或摘要。

步骤 6:验证

快速检查:

  • 更改解决了用户提出的问题
  • 没有引入新问题
  • Skill 仍遵循最佳实践

与 reviewing-skills 的主要区别

reviewing-skillsimproving-skills
仅进行技术分析用户反馈 + 技术分析
提供反馈实施更改
只读可读写

评论

支持 Markdown