示例命令技能
演示可调用技能如何接收参数、执行操作并返回结果。
技能明确为用户调用，并限制在 Read、Glob、Grep、Bash 工具范围内；但 Bash 权限较宽，未规定最小权限、用户确认、数据流、敏感数据处理、外部副作用或回滚，因此扣分。
文件结构、参数占位符和调用步骤基本一致，正常路径可理解；但未定义参数解析规则、异常输入、依赖检查、失败反馈或可复现测试，且本次仅静态审查，按校准限制扣分。
描述了用户调用场景、参数提示和两个简单示例；但“requested action”未定义，缺少输入输出契约、非适用边界、精确触发条件及中文和大陆网络适配证据，因此扣分。
frontmatter、目录布局、帮助描述和示例较清晰，仓库提供 Apache-2.0 许可证及官方维护背景；但技能自身没有安装说明、版本、变更记录、已知限制、FAQ或明确维护更新路径，因此扣分。
它能展示技能格式和调用流程，但实际任务被抽象为“执行用户请求的操作”，没有具体能力或可验证输出，用户仍需自行补充大量指令，边际价值有限。
源文件本身可审计，frontmatter 和示例可核对；但没有针对该技能的测试、CI 覆盖、第三方执行证据或多源交叉验证，静态校准下不得高于5分。
- 这是格式演示技能，不是定义完整业务能力的生产技能；“执行请求的操作”无法据此判断实际结果。
- 预批准 Bash 权限较宽，使用前应确认具体命令、文件范围和潜在外部副作用。
- 未提供错误处理、回滚、敏感数据和网络依赖说明；本评估未执行技能或测试。
它能做什么 & 适用场景
这是一个面向用户调用的示例技能，用于展示 `skills/<name>/SKILL.md` 的目录布局和前置元数据选项。调用后，它会解析用户提供的参数，使用预先允许的工具执行请求，并向用户报告结果。该技能与旧版 `commands/example-command.md` 格式在功能上相同。它更适合作为 Claude Code 插件开发参考，而不是具有明确业务能力的生产技能。
读取 $ARGUMENTS 中的用户参数并进行解析；根据请求使用 Read、Glob、Grep 或 Bash 等允许的工具执行操作；将执行结果报告给用户。具体操作由用户请求决定，源文件未规定固定的业务任务。
- 正在开发 Claude Code 插件、需要参考 `skills/<name>/SKILL.md` 布局的开发者。
- 需要展示 `name`、`description`、`argument-hint` 和 `allowed-tools` 等前置字段用法的插件作者。
- 需要验证用户调用参数如何传入技能的开发者。
优缺点一览
- 结构清晰，展示了用户调用技能的完整基本布局。
- 明确列出可用工具，包含 Read、Glob、Grep 和 Bash。
- 提供参数提示和调用示例，适合插件开发参考。
- 这是演示技能，不提供明确的领域功能或固定工作流。
- 实际执行内容取决于用户请求，源材料未提供测试用例或成功标准。
- 使用了 `$ARGUMENTS`、斜杠命令和 `allowed-tools` 等 Claude Code 相关机制，移植到其他客户端需要调整。
如何安装
先在 Claude Code 中安装官方插件目录中的目标插件：/plugin install example-plugin@claude-plugins-official。源材料未说明其他客户端的安装步骤，也未提供单独安装该技能的命令。
如何使用
在 Claude Code 中调用：/example-command my-argument，或调用：/example-command arg1 arg2。技能会解析参数、执行用户要求的操作，并报告结果。源文件未规定具体操作内容。
对比同类
源文件明确将其与旧版 commands/example-command.md 格式比较：两者功能相同，加载方式相同，区别仅在文件布局。