Skills · Claude Code · Agent Skills

技能就是软件包:版本、门禁与发布 — 没有商量余地。

以完整的目录结构、精简的 description、四处一致的版本号、带红色用例测试的脚本,以及仅在门禁通过时才发布的方式,创建并维护目录中的技能。

v0.2.0Disciplina · Autoria de skillsgithub.com/schematizeme/skill-skill-dev

维护者 Lucas Andrade

schematize-skill-dev · v0.2.0bash
$ schematize install skill-dev
GitHub →下载技能 (.zip)/skill-dev-help · github.com/schematizeme/schematize-cli

不可妥协的底线

绝不为“求快”而关闭。完整清单见技能。

每个技能一个仓库

目录为 skill-[slug],name 为 schematize-[slug],拥有独立的公开仓库,命令前缀在整个目录中唯一。

完整的目录结构

SKILL.md、skill.toml、VERSION、CHANGELOG、README、LICENSE、install.sh、assets、references、scripts,以及 versions/ 中的快照;包内不放 zip。

简短且划清边界的 description

不超过 350 字符的 >- 块:它是什么、具体的触发场景,以及与相邻技能的边界,不侵占他人领域。

四处版本一致

VERSION、skill.toml、frontmatter 与 SKILL.md 的版本行一致,CHANGELOG 说明原因,skills.json 同步更新。

继承块绝不手改

来源是 schematize-engineering;在那里修改并运行 sync,绝不直接在技能中编辑继承块。

每个脚本都有红绿测试

红色用例要先看到它失败再通过:不会拒绝的门禁只是摆设。

门禁通过才发布

工作区干净、main 已同步、git add 使用明确清单、带注释的标签、顶层为 schematize-[slug]/ 的 zip,随后重新生成图谱与 skills.json。

命令

安装在 .claude/commands/。随时运行 /skill-help。

/skill-bump在四处同步提升版本号,写入快照并要求补全 CHANGELOG 条目。
/skill-ccContext compact:将上下文和清单写入归档并运行 /compact。
/skill-claude在仓库根目录创建或合并常开的 skill-dev CLAUDE.md(不覆盖其他技能的区块)。
/skill-handoff生成上下文交接而不压缩——会话结束或任务切换。
/skill-help列出所有命令。
/skill-load强制加载全部规范内容:结构、description、继承块、lint 与测试、发布与目录。
/skill-new生成一个已能通过门禁的完整新技能脚手架。
/skill-release发布流程:门禁、升版、快照、zip、标签、GitHub Release、图谱与 skills.json。
/skill-review对照底线审计技能:门禁、目录 lint,并检查机器读不出的部分。

面向 AI 智能体

无需人工即可安装。元数据见 llms.txt。

  • 运行:git clone https://github.com/schematizeme/skill-skill-dev.git && ./skill-skill-dev/install.sh
  • 或下载:https://github.com/schematizeme/skill-skill-dev/releases/latest/download/skill-skill-dev.zip 并解压到 .claude/skills/
  • 将 assets/CLAUDE.md 复制到仓库根目录(常开规则)。
  • 用 /skill-help 确认。

不想安装?

阅读完整规范并直接复制到你的项目——或安装该技能,让智能体自动执行。