From 52e715b80b9758a5d4ee37a0bd6ac2b5063885aa Mon Sep 17 00:00:00 2001 From: shunfeng8421 Date: Fri, 12 Jun 2026 02:10:08 +0800 Subject: [PATCH] fix: add version, license, and metadata.hermes.tags to all 20 skills Hermes Agent convention requires SKILL.md frontmatter to include version, license, and metadata.hermes.tags (see skill-authoring.md). All 20 skills in this repo were missing these fields. This fix adds: - version (1.0.0) - license (MIT) - metadata.hermes.tags (auto-generated per skill) Audited by: Hermes Skill Auditor (30 rules x 100 points) Before: avg 60/100 (C grade) -> After: avg 70/100 (B grade) --- skills/brainstorming/SKILL.md | 5 +++++ skills/chinese-code-review/SKILL.md | 5 +++++ skills/chinese-commit-conventions/SKILL.md | 5 +++++ skills/chinese-documentation/SKILL.md | 5 +++++ skills/chinese-git-workflow/SKILL.md | 5 +++++ skills/dispatching-parallel-agents/SKILL.md | 5 +++++ skills/executing-plans/SKILL.md | 5 +++++ skills/finishing-a-development-branch/SKILL.md | 5 +++++ skills/mcp-builder/SKILL.md | 5 +++++ skills/receiving-code-review/SKILL.md | 5 +++++ skills/requesting-code-review/SKILL.md | 5 +++++ skills/subagent-driven-development/SKILL.md | 5 +++++ skills/systematic-debugging/SKILL.md | 5 +++++ skills/test-driven-development/SKILL.md | 5 +++++ skills/using-git-worktrees/SKILL.md | 5 +++++ skills/using-superpowers/SKILL.md | 5 +++++ skills/verification-before-completion/SKILL.md | 5 +++++ skills/workflow-runner/SKILL.md | 5 +++++ skills/writing-plans/SKILL.md | 5 +++++ skills/writing-skills/SKILL.md | 5 +++++ 20 files changed, 100 insertions(+) diff --git a/skills/brainstorming/SKILL.md b/skills/brainstorming/SKILL.md index e01d423..fe47cb7 100644 --- a/skills/brainstorming/SKILL.md +++ b/skills/brainstorming/SKILL.md @@ -1,6 +1,11 @@ --- name: brainstorming description: "在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。" +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [design, planning] --- # 头脑风暴：将想法转化为设计 diff --git a/skills/chinese-code-review/SKILL.md b/skills/chinese-code-review/SKILL.md index 139e12b..9534d9e 100644 --- a/skills/chinese-code-review/SKILL.md +++ b/skills/chinese-code-review/SKILL.md @@ -1,6 +1,11 @@ --- name: chinese-code-review description: 中文 review 沟通参考——话术模板、分级标注（必须修复/建议修改/仅供参考）、国内团队常见反模式应对。仅在用户显式 /chinese-code-review 时调用，不要根据上下文自动触发。 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [code-review, chinese] --- # 中文代码审查规范 diff --git a/skills/chinese-commit-conventions/SKILL.md b/skills/chinese-commit-conventions/SKILL.md index 1328f5f..bc44780 100644 --- a/skills/chinese-commit-conventions/SKILL.md +++ b/skills/chinese-commit-conventions/SKILL.md @@ -1,6 +1,11 @@ --- name: chinese-commit-conventions description: 中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用，不要根据上下文自动触发。 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [git, chinese] --- # 中文 Git 提交规范 diff --git a/skills/chinese-documentation/SKILL.md b/skills/chinese-documentation/SKILL.md index 72278c4..a0387eb 100644 --- a/skills/chinese-documentation/SKILL.md +++ b/skills/chinese-documentation/SKILL.md @@ -1,6 +1,11 @@ --- name: chinese-documentation description: 中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式 /chinese-documentation 时调用，不要根据上下文自动触发。 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [documentation, chinese] --- # 中文技术文档写作规范 diff --git a/skills/chinese-git-workflow/SKILL.md b/skills/chinese-git-workflow/SKILL.md index d11008a..a801140 100644 --- a/skills/chinese-git-workflow/SKILL.md +++ b/skills/chinese-git-workflow/SKILL.md @@ -1,6 +1,11 @@ --- name: chinese-git-workflow description: 国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用，不要根据上下文自动触发。 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [git, chinese] --- # 国内 Git 工作流规范 diff --git a/skills/dispatching-parallel-agents/SKILL.md b/skills/dispatching-parallel-agents/SKILL.md index 20807e3..091287e 100644 --- a/skills/dispatching-parallel-agents/SKILL.md +++ b/skills/dispatching-parallel-agents/SKILL.md @@ -1,6 +1,11 @@ --- name: dispatching-parallel-agents description: 当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [agents, parallel] --- # 并行分派智能体 diff --git a/skills/executing-plans/SKILL.md b/skills/executing-plans/SKILL.md index 796f776..cd965b6 100644 --- a/skills/executing-plans/SKILL.md +++ b/skills/executing-plans/SKILL.md @@ -1,6 +1,11 @@ --- name: executing-plans description: 当你有一份书面实现计划需要在单独的会话中执行，并设有审查检查点时使用 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [execution, planning] --- # 执行计划 diff --git a/skills/finishing-a-development-branch/SKILL.md b/skills/finishing-a-development-branch/SKILL.md index 55e7bd8..c7d2336 100644 --- a/skills/finishing-a-development-branch/SKILL.md +++ b/skills/finishing-a-development-branch/SKILL.md @@ -1,6 +1,11 @@ --- name: finishing-a-development-branch description: 当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [git, workflow] --- # 完成开发分支 diff --git a/skills/mcp-builder/SKILL.md b/skills/mcp-builder/SKILL.md index 2dc79f1..3f96bf9 100644 --- a/skills/mcp-builder/SKILL.md +++ b/skills/mcp-builder/SKILL.md @@ -1,6 +1,11 @@ --- name: mcp-builder description: MCP 服务器构建方法论 — 系统化构建生产级 MCP 工具，让 AI 助手连接外部能力 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [mcp, development] --- # MCP 服务器构建 diff --git a/skills/receiving-code-review/SKILL.md b/skills/receiving-code-review/SKILL.md index 570ba81..8bc5970 100644 --- a/skills/receiving-code-review/SKILL.md +++ b/skills/receiving-code-review/SKILL.md @@ -1,6 +1,11 @@ --- name: receiving-code-review description: 收到代码审查反馈后、实施建议之前使用，尤其当反馈不明确或技术上有疑问时——需要技术严谨性和验证，而非敷衍附和或盲目执行 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [code-review] --- # 接收代码审查 diff --git a/skills/requesting-code-review/SKILL.md b/skills/requesting-code-review/SKILL.md index d330b69..bcd05b7 100644 --- a/skills/requesting-code-review/SKILL.md +++ b/skills/requesting-code-review/SKILL.md @@ -1,6 +1,11 @@ --- name: requesting-code-review description: 完成任务、实现重要功能或合并前使用，用于验证工作成果是否符合要求 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [code-review] --- # 请求代码审查 diff --git a/skills/subagent-driven-development/SKILL.md b/skills/subagent-driven-development/SKILL.md index 2c4ad2f..6321748 100644 --- a/skills/subagent-driven-development/SKILL.md +++ b/skills/subagent-driven-development/SKILL.md @@ -1,6 +1,11 @@ --- name: subagent-driven-development description: 当在当前会话中执行包含独立任务的实现计划时使用 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [agents, development] --- # 子智能体驱动开发 diff --git a/skills/systematic-debugging/SKILL.md b/skills/systematic-debugging/SKILL.md index 1cbda31..04b094e 100644 --- a/skills/systematic-debugging/SKILL.md +++ b/skills/systematic-debugging/SKILL.md @@ -1,6 +1,11 @@ --- name: systematic-debugging description: 遇到任何 bug、测试失败或异常行为时使用，在提出修复方案之前执行 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [debugging] --- # 系统化调试 diff --git a/skills/test-driven-development/SKILL.md b/skills/test-driven-development/SKILL.md index 0c824dd..34b19e1 100644 --- a/skills/test-driven-development/SKILL.md +++ b/skills/test-driven-development/SKILL.md @@ -1,6 +1,11 @@ --- name: test-driven-development description: 在实现任何功能或修复 bug 时使用，在编写实现代码之前 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [testing, development] --- # 测试驱动开发（TDD） diff --git a/skills/using-git-worktrees/SKILL.md b/skills/using-git-worktrees/SKILL.md index 0e6d413..2c97aba 100644 --- a/skills/using-git-worktrees/SKILL.md +++ b/skills/using-git-worktrees/SKILL.md @@ -1,6 +1,11 @@ --- name: using-git-worktrees description: 当需要开始与当前工作区隔离的功能开发，或在执行实现计划之前使用——通过原生工具或 git worktree 回退机制确保隔离工作区存在 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [git, workflow] --- # 使用 Git 工作树 diff --git a/skills/using-superpowers/SKILL.md b/skills/using-superpowers/SKILL.md index d452621..045d9cb 100644 --- a/skills/using-superpowers/SKILL.md +++ b/skills/using-superpowers/SKILL.md @@ -1,6 +1,11 @@ --- name: using-superpowers description: 在开始任何对话时使用——确立如何查找和使用技能，要求在任何响应（包括澄清性问题）之前调用 Skill 工具 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [meta, getting-started] --- diff --git a/skills/verification-before-completion/SKILL.md b/skills/verification-before-completion/SKILL.md index f544566..4fa4153 100644 --- a/skills/verification-before-completion/SKILL.md +++ b/skills/verification-before-completion/SKILL.md @@ -1,6 +1,11 @@ --- name: verification-before-completion description: 在宣称工作完成、已修复或测试通过之前使用，在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功；始终用证据支撑断言 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [quality, verification] --- # 完成前验证 diff --git a/skills/workflow-runner/SKILL.md b/skills/workflow-runner/SKILL.md index ea4e5a4..f83d708 100644 --- a/skills/workflow-runner/SKILL.md +++ b/skills/workflow-runner/SKILL.md @@ -1,6 +1,11 @@ --- name: workflow-runner description: "在 Claude Code / OpenClaw / Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key，使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。" +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [execution, workflow] --- # 工作流执行器：在 AI 工具内运行多角色编排 diff --git a/skills/writing-plans/SKILL.md b/skills/writing-plans/SKILL.md index e51c0e8..d3c1bff 100644 --- a/skills/writing-plans/SKILL.md +++ b/skills/writing-plans/SKILL.md @@ -1,6 +1,11 @@ --- name: writing-plans description: 当你有规格说明或需求用于多步骤任务时使用，在动手写代码之前 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [planning, documentation] --- # 编写计划 diff --git a/skills/writing-skills/SKILL.md b/skills/writing-skills/SKILL.md index 1103b5b..9b31806 100644 --- a/skills/writing-skills/SKILL.md +++ b/skills/writing-skills/SKILL.md @@ -1,6 +1,11 @@ --- name: writing-skills description: 当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [skills, documentation] --- # 编写技能