mcpField
E
example-skill

example-skill

github.com/vincentkocAgent 工作流11138 次安装3 天前更新
代码仓库

关于 example-skill

example-skill 是用于创建和维护规范一致技能的可复用模板，指导贡献者编写必需章节、运行确定性检查并采用稳定的输出格式。

主要功能

  1. 01符合规范的技能模板
  2. 02引导输入与输出结构
  3. 03按需加载参考内容
  4. 04确定性预检脚本
  5. 05检查 frontmatter 与路径

适用场景

  1. 01创建包含必需章节的技能骨架
  2. 02将详细内容移至参考文件
  3. 03添加可重复运行的验证检查

安装

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

$npx skills add https://github.com/vincentkoc/dotskills --skill example-skill

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

详细介绍

示例技能

用途

提供一个符合规范的模板，用于创建一致且可复用的技能。

适用场景

  • 你要在此仓库中添加新技能。
  • 你想要一个包含必需章节的起始结构。

工作流

  1. 用一句话说明目标。
  2. 仅收集必需的输入。
  3. 执行确定性步骤。
  4. 仅在需要时加载更深入的上下文：
    • references/REFERENCE.md
    • assets/output-template.md
    • agents/openai.yaml
  5. 以稳定的格式返回输出。
  6. 使用 scripts/example-check.sh 执行确定性的预检。

输入

  • 任务目标
  • 约束
  • 输出位置

输出

  • 主要交付物
  • 后续检查

示例

  • 构建包含必需章节和有效 frontmatter 的新技能骨架。
  • 重构现有技能，将深入细节移至 references/。
  • 在 scripts/ 下添加确定性检查，以便重复验证。

边缘情况

  • 缺少 frontmatter 字段：停止操作，先添加必需字段。
  • name 格式无效：将其规范化为小写字母加连字符的格式，并与目录名称保持一致。
  • 资源路径无效：修复链接，确保所有引用的文件都存在。

防护措施

  • 确保指令具体且可测试。
  • 避免加载不必要的上下文。
  • 优先使用确定性命令，而非手动步骤。
  • 文件引用与 SKILL.md 的相对层级不超过一层。

评论

支持 Markdown