mcpField
P
project-skill-scripts

project-skill-scripts

github.com/laurigatesAgent 工作流5935 次安装1 天前更新
代码仓库

关于 project-skill-scripts

project-skill-scripts 是用于分析插件技能并寻找脚本优化机会的工作流，也可按需创建脚本。它面向维护多个插件技能的开发者，提供候选评估、脚本生成和结果汇报步骤。

主要功能

  1. 01扫描技能并评估脚本机会
  2. 02统计脚本覆盖情况
  3. 03按候选技能创建脚本
  4. 04更新技能文档并汇报结果
  5. 05支持分析、单项创建和批量模式

适用场景

  1. 01检查插件技能组合中的脚本覆盖
  2. 02为重复命令流程生成辅助脚本
  3. 03批量处理适合脚本化的技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/laurigates/claude-plugins --skill project-skill-scripts

安装后在 Claude Code 中输入/project-skill-scripts确认已加载。

详细介绍

/project:skill-scripts

分析插件技能，找出通过支持脚本提升性能（减少令牌用量、加快执行速度、确保结果一致）的机会，然后可选择创建这些脚本。

何时使用此技能

在以下情况下使用此技能……在以下情况下使用替代方案……
分析技能改进机会需要为某项技能创建单个脚本
在多个插件中批量创建脚本为某个特定需求创建一次性脚本
衡量整个组合中的脚本覆盖率已完成脚本生成

上下文

  • 插件根目录：!git rev-parse --show-toplevel
  • 插件总数：!find . -maxdepth 2 -name 'plugin.json' -type f
  • 含有脚本的技能：!find . -name 'scripts/*.sh' -type f

参数

解析 $ARGUMENTS：

  • --analyze：扫描所有技能并报告候选项（默认）
  • --create <plugin/skill>：仅为指定技能创建脚本
  • --all：分析并为所有高分候选项创建脚本

执行

执行此技能的脚本分析与创建工作流：

第 1 步：运行分析脚本

运行分析器，获取所有技能的结构化数据：

  1. 运行分析器：bash "${CLAUDE_PLUGIN_ROOT}/skills/project-discovery/scripts/analyze-skills.sh" $(git rev-parse --show-toplevel 2>/dev/null || echo '.')
  2. 解析输出，识别：
    • 当前覆盖率（含有脚本的技能）
    • 高分候选项（得分 >= 8）
    • 脚本类型建议
第 2 步：分析候选项（--create 或 --all 模式）

对于每个候选技能：

  1. 阅读 SKILL.md，了解工作流
  2. 识别脚本机会模式：
    • 多个连续的 git/gh 命令 → 上下文收集脚本
    • 多阶段工作流 → 工作流脚本
    • 项目类型检测 + 条件执行 → 多工具脚本
    • 使用不同参数重复执行的命令 → 工具脚本
  3. 评估收益：>= 4 次工具调用、一致性、错误处理、复用频率
  4. 满足以下情况时跳过：单个简单命令、交互式/创意型任务、结构已经完善
第 3 步：创建脚本

对于批准的候选项：

  1. 使用包含结构化输出（KEY=value、分节标记）的标准脚本模板
  2. 遵循设计原则：结构化输出、弹性错误处理、限制输出、可移植
  3. 将脚本放在 <plugin>/skills/<skill-name>/scripts/<script-name>.sh
  4. 使脚本可执行：chmod +x <path>
  5. 在 SKILL.md 中添加“推荐”部分并引用该脚本
  6. 更新 frontmatter 中的 modified: 日期
第 4 步：报告结果

报告以下发现：

  • 当前覆盖率（X/Y 项技能含有脚本）
  • 已创建的脚本（插件、技能、脚本、类型、替代的命令）
  • 剩余候选项（插件、技能、得分、类型、建议）
  • 后续步骤（测试、提交）
第 5 步：提交更改

如果已创建脚本：

feat(<affected-plugins>): add supporting scripts to skills

在正文中包含：

  • 创建了哪些脚本
  • 它们替代了什么（节省的令牌/调用次数）
  • 更新了哪些 SKILL.md 文件

示例

仅分析
$ /project:skill-scripts --analyze

Skill Scripts Analysis

Current Coverage: 5/191 skills have supporting scripts

Top Candidates:
  git-plugin/gh-cli-agentic         score=14  type=context-gather
  kubernetes-plugin/kubectl-debugging score=12  type=multi-tool
  testing-plugin/playwright-testing   score=10  type=workflow
为指定技能创建
$ /project:skill-scripts --create testing-plugin/playwright-testing

Analyzing testing-plugin/playwright-testing...
Found: 6 bash blocks, 3 phases, 12 commands

Creating scripts/run-tests.sh...
- Consolidates: test discovery, execution, report parsing
- Replaces: 5 individual tool calls
- Output: structured test results with file:line references

Updated SKILL.md with "Recommended" section.

错误处理

情况操作
技能没有 bash 模式跳过，并报告“没有脚本机会”
脚本已存在报告现有脚本，并询问是否覆盖
SKILL.md 只读报告错误，并建议手动更新
未找到插件列出可用插件

评论

支持 Markdown