| 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：加/改技能 checklistreferences/principles-authoring.md：维护 principles
