skill-architecturelisted

# Skill Architecture（元技能） 本库新增技能 / 新领域 / 从零建库 / 维护 principles 时使用，保证产出符合架构约定。 ## 核心理念 - **瓦技能是核心**。一个瓦技能可独立存在，不要求进任何 chain。 - **chain 是可选的主动编排**。只有你需要把多个瓦技能串成端到端交付时才主动建（见 `chain-authoring.md`）。加瓦技能不触发自动改 chain。 - **本模块自包含**。`assets/` 带完整范本，`references/` 带全部规则，单独拎出即可复现架构。 ## 场景 A：加瓦技能（最高频） 1. 用 `assets/skill-template/SKILL.md` 建技能文件夹。 2. description 写到能触发。 3. 按需加 references/。 4. bump 所在 plugin version，并同步 marketplace 中的 version。 5. `claude plugin validate . --strict` + `node scripts/validate-repository.mjs --base HEAD`。 6. 不碰 chain。 ## 场景 B：建新 domain 1. 建 `plugins/domain-<name>/` + `.claude-plugin/plugin.json`。 2. 瓦技能进 `skills/<skill>/SKILL.md`。 3. marketplace.json 注册新 plugin。 4. 同步 plugin/marketplace version，运行两项仓库验证。 5. 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/principle