| name | skill-architecture |
| description | Use when adding a skill, a new domain, bootstrapping the skill library from scratch, or extending principles. Generates spec-compliant plugin/skill skeletons, enforces the on-disk delivery protocol, and keeps the architecture self-contained and iterable. Always use this instead of hand-creating skill folders. |
Skill Architecture(元技能)
本库新增技能 / 新领域 / 从零建库 / 维护 principles 时使用,保证产出符合架构约定。
核心理念
- 瓦技能是核心。一个瓦技能可独立存在,不要求进任何 chain。
- chain 是可选的主动编排。只有你需要把多个瓦技能串成端到端交付时才主动建(见
chain-authoring.md)。加瓦技能不触发自动改 chain。
- 本模块自包含。
assets/ 带完整范本,references/ 带全部规则,单独拎出即可复现架构。
场景 A:加瓦技能(最高频)
- 用
assets/skill-template/SKILL.md 建技能文件夹。
- description 写到能触发。
- 按需加 references/。
- bump 所在 plugin version,并同步 marketplace 中的 version。
claude plugin validate . --strict + node scripts/validate-repository.mjs --base HEAD。
- 不碰 chain。
场景 B:建新 domain
- 建
plugins/domain-<name>/ + .claude-plugin/plugin.json。
- 瓦技能进
skills/<skill>/SKILL.md。
- marketplace.json 注册新 plugin。
- 同步 plugin/marketplace version,运行两项仓库验证。
- chain 可选,不自动建。
场景 C:主动建/改 chain
你主动要把多个瓦技能串成工作流时,读 chain-authoring.md。chain 不是加技能的副作用;改 chain 后必须同步 workflow 文档、bump orchestrator version 并通过两项仓库验证。
从零建库
换环境或单独使用本模块时,读 references/bootstrap-from-scratch.md,从空目录长出三层架构。
维护 principles
principles 是 Agent 操作原则:认知原型、DO/DON'T、CALIBRATION。被动参考库,不是全局强制规则。更新时保持克制:只写跨 domain 成立、可执行、可检验的原则。详见 principles-authoring.md。
参考
assets/skill-template/SKILL.md:瓦技能范本
assets/chain-template.md:chain 范本
assets/skill-index-template/:skill-index plugin 模板(SKILL.md + 2 references)
references/plugin-conventions.md:架构全貌 + 命名/版本/落盘约定
references/bootstrap-from-scratch.md:从零建库
references/chain-authoring.md:chain 生命周期
references/migration-checklist.md:加/改技能 checklist
references/principles-authoring.md:维护 principles