agent-skills 接入 Command Code用 cmd skills 原生安装、管理与发现 25 个工程技能【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills本文讲解如何在 Command Code 中通过其内置的cmd skills命令原生安装、管理和使用 agent-skills 技能包从项目级/用户级两种安装作用域、单技能挑选与分支指定到 TUI 斜杠菜单中的自动发现机制以及技能存放路径的完整解析规则。读完本文你可以在任意项目中一键接入这套 25 个生产级工程技能并理解 Command Code 是如何递归发现SKILL.md文件并完成技能装载的。Command Code 原生技能系统的工作原理Command Code 自带一套原生技能skills系统核心是内置的cmd skills命令。它的工作流程是克隆你指定的 GitHub 仓库递归发现仓库中的每一个SKILL.md文件交互式地让你勾选要安装的技能并写入对应的技能目录。Command Code 的可执行文件名为cmd在 Windows 上的别名为cmdc另有command-code别名。下文示例统一使用cmd。这套机制能直接对接 agent-skills 仓库正是因为仓库的每个技能都遵循「一个目录 一份SKILL.md」的标准结构。仓库的skills/目录当前共有 25 个技能目录例如 skills/spec-driven-development/SKILL.md、skills/interview-me/SKILL.md、skills/using-agent-skills/SKILL.md 等。递归扫描SKILL.md恰好能完整覆盖这些技能而每个目录下的可选支撑文件如 skills/idea-refine/frameworks.md、skills/idea-refine/scripts/idea-refine.sh也随目录整体安装。SKILL.md本身以 YAML frontmatter 开头这是 Command Code 识别与展示技能的关键--- name: spec-driven-development description: Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. … ---frontmatter 中name必须与技能目录名一致小写连字符命名description需要同时说明技能「做什么」和「何时触发」Use when…。这一点在仓库的格式规范 docs/skill-anatomy.md 中有明确定义Agent 靠 description 决定何时激活某个技能而 TUI 斜杠菜单里显示的提示文本也正是来自这里。仓库还通过 scripts/validate-skills.js 对每个技能做 lint 校验规则集中在 scripts/lib/skill-lint.js保证技能包在安装到任意 Agent 之前结构合法——这保证了cmd skills递归发现到的每一份SKILL.md都是可被正确解析的。安装技能项目级安装默认作用域在项目根目录执行cmd skills add addyosmani/agent-skills技能会安装到当前 git 仓库根目录下的.commandcode/skills/。在交互式终端中命令会弹出一个多选界面让你从发现的 25 个技能中勾选要安装的子集如果通过管道或以非交互方式调用则安装所有被发现的技能。安装指定技能只想要某一个技能时用-s参数指定技能名cmd skills add addyosmani/agent-skills -s spec-driven-development例如spec-driven-development对应的技能定义了 SPECIFY → PLAN → TASKS → IMPLEMENT 四阶段门控工作流每个阶段都要人工评审后才进入下一阶段interview-me则是「一次只问一个问题」的需求澄清流程。技能名即skills/下的目录名也是 frontmatter 里的name值。用户级安装全局作用域加--global把技能安装到~/.commandcode/skills/在所有项目中可用cmd skills add addyosmani/agent-skills --global其他支持的参数形式cmd skills add addyosmani/agent-skillsmain # 指定分支 cmd skills add addyosmani/agent-skills/skills/interview-me # 指定仓库内的具体路径 cmd skills add addyosmani/agent-skills --force # 已安装时覆盖/更新main后缀固定从main分支拉取适合需要在特定分支版本上锁定技能的场景直接给到仓库内路径如.../skills/interview-me时Command Code 只从该路径出发发现SKILL.md等价于安装单个技能--force会重新拉取并覆盖已存在的技能这也是把技能更新到最新版本的方式。管理已安装的技能cmd skills list # 列出已安装技能project user bundled cmd skills remove spec-driven-development # 移除项目级技能 cmd skills remove spec-driven-development --global # 移除用户级技能list会聚合三个来源项目级.commandcode/skills/、用户级~/.commandcode/skills/以及 Command Code 自带的 bundled 技能remove默认只作用于项目级需要--global才作用于用户级。更新技能没有单独的 update 子命令统一用add ... --force重拉覆盖。在 TUI 中使用技能安装完成后无需任何额外配置——技能被自动发现并出现在 TUI 的斜杠菜单中带有[skill]标签/spec-driven-development [skill] Write a spec before writing code…输入/浏览全部命令与技能继续输入技能名前缀即可过滤使用/skills可以启用/禁用单个技能无需重新安装。斜杠菜单里的提示语如 Write a spec before writing code…来自各SKILL.md的description字段这也是为什么 agent-skills 对每条 description 都要求写清「做什么 何时用」它同时服务于 Agent 的按需激活判断和人类在菜单里的快速识别。技能发现路径四个作用位置一览Command Code 会从以下位置发现技能项目级条目相对于最近的 git 根目录解析ScopePathProject.commandcode/skills/name/SKILL.mdProject (agents-compat).agents/skills/name/SKILL.mdUser~/.commandcode/skills/name/SKILL.mdUser (agents-compat)~/.agents/skills/name/SKILL.mdcmd skills add的写入目标是.commandcode/skills/项目级或~/.commandcode/skills/--global。其中两组agents-compat路径值得注意从源码结构看agent-skills 面向多个 Agent 工具Claude Code、Gemini CLI、OpenCode、Copilot 等而这些工具普遍遵循.agents/skills/name/SKILL.md这一跨工具约定。例如 docs/gemini-cli-setup.md 说明 Gemini CLI 会同时自动发现.gemini/skills/或.agents/skills/docs/opencode-setup.md 也列出.agents/skills/作为通用兼容路径。这意味着如果你把技能手动放入.agents/skills/或~/.agents/skills/Command Code、Gemini CLI、OpenCode 等工具都能发现同一份技能文件实现跨工具共享同一套技能安装而不必为每个工具维护一份拷贝。为什么这套技能能被递归发现SKILL.md 的目录契约Command Code 的发现逻辑是递归找SKILL.md它对技能目录内部结构没有额外要求只要求入口文件存在。agent-skills 的技能目录则遵循更完整的契约见 docs/skill-anatomy.mdskills/ skill-name/ SKILL.md # 必需技能定义frontmatter 工作流正文 scripts/ # 可选技能工作流使用的可执行辅助脚本 references/ # 可选技能专属参考文档每个技能是一个自包含目录SKILL.md是唯一必需文件例如最精简的 skills/ci-cd-and-automation/ 只有一个SKILL.md而skills/idea-refine/则额外携带examples.md、frameworks.md、refinement-criteria.md和scripts/技能正文按统一的章节骨架组织Overview是什么、When to Use何时用/何时不用、核心流程分步工作流、Common Rationalizations借口-反驳对照表、Red Flags违规信号、Verification带证据要求的退出条件。这种流程而非散文的写法保证了 Agent 装载技能后拿到的是可执行步骤而不是需要自行发挥的参考文档渐进式披露progressive disclosure机制下启动时只有技能名与 description 进入上下文完整SKILL.md在被判定相关后才加载——这与 Command Code「斜杠菜单里只展示一行描述」的呈现方式正好对应。此外技能包还包含位于仓库根目录的 references/ 共享清单如 references/security-checklist.md、references/testing-patterns.md。从源码结构看整仓安装cmd skills add addyosmani/agent-skills不带路径参数、勾选全部技能时技能目录整体拷贝会保留技能对这些清单的引用但如果只安装单个技能目录-s参数或指定仓库内路径这些技能正文中指向仓库级references/的链接可能解析不到——这一点与 README.md 中提到的单技能安装可移植性限制issue #361一致属于已知边界使用时按需把所需清单复制进对应技能的references/目录即可。安装后的验证清单完成安装后可以按以下步骤确认技能真正生效cmd skills list能看到目标技能并确认其作用域project 或 user符合预期在 TUI 中输入/ 技能名前缀确认它出现在斜杠菜单且带[skill]标签实际触发一次例如输入/spec-driven-development观察 Agent 是否开始执行该技能定义的步骤如 SPECIFY 阶段输出规格文档若技能不生效检查项目级技能是否放在 git 根目录下的.commandcode/skills/name/SKILL.mdCommand Code 以最近的 git 根为基准解析项目级路径需要更新时执行cmd skills add addyosmani/agent-skills --force重新拉取覆盖需要卸载时用cmd skills remove name用户级加--global。适用前提与限制上述所有行为基于 Command Code 当前版本的cmd skills子命令以及 agent-skills 仓库skills/目录下现有的 25 个技能24 个生命周期技能 using-agent-skills元技能cmd skills add依赖联网克隆 GitHub 仓库因此需要可访问该仓库的网络环境项目级安装要求当前处于一个 git 仓库内技能写入当前 git 根目录下的.commandcode/skills/在用户主目录等无 git 根的位置应改用--global技能只是工作流指令最终执行仍由 Command Code 的 Agent 完成技能中的验证门如测试必须通过、变更需附证据要求 Agent 具备实际运行测试和命令的权限。如果你想了解同一套技能在其他 Agent 工具Claude Code、Codex、Gemini CLI、Cursor 等中的接入方式可参考 README.md 的 Quick Start 一节及 docs/ 下各工具的专属安装指南。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考