用途：指导 Claude Code 插件的设计与架构，涵盖组件选型、架构模式、清单配置、文件结构、版本管理与市场发布。单个组件的编写另见 writing-skills、writing-agents、writing-hooks、writing-rules。
主要能力：插件由 Commands、Agents、Skills、Hooks 组合而成。组件选型：用户主动触发用 Command，需 AI 判断用 Agent，需领域知识用 Skill，事件自动触发用 Hook，外部服务集成用 MCP 服务器（.mcp.json）。最小可用插件只含一个组件；不必需时不加其他组件以减少维护负担。
架构模式：单命令（简单确定性任务）、命令+单 Agent（有明确入口的 AI 判断）、命令+多 Agent 并行（同一输入的多个独立分析）、命令+Agent 顺序流水线（各阶段依赖前一步）、纯 Hooks（无需用户命令的策略强制）。选型判断：用户显式触发则需命令，否则用 hooks；需 AI 判断则用 agents；存在独立子分析则并行，各步依赖则流水线。
清单与结构：plugin.json 中仅 name 必填，推荐补 version、description、author.name、license、keywords、category。commands/、agents/、skills/、hooks/ 会被自动发现，commands/shared/ 不可调用；scripts/ 不自动发现。命名采用 kebab-case，技能固定为 SKILL.md。复用逻辑可抽到 commands/shared/*.md 并设 user-invocable: false，但仅在 3 个以上调用方时抽取。
版本与发布：遵循 semver；升级需同步四处（插件清单、插件 marketplace.json、中心 marketplace 清单、中心 README 版本表），先推插件仓库再更新中心市场。发布前用 claude plugin validate /path/to/plugin 校验，测试命令的无参、常规与边界情况，以及 Agent 触发准确性。安装验证：claude plugin install my-plugin@xiaolai --scope project。
限制：路径不得硬编码，统一用 ${CLAUDE_PLUGIN_ROOT}；技能超过 500 行应拆到 references/；hooks 拦截需给出 permissionDecisionReason；CLAUDE.md 面向 AI 讲架构，README 面向用户。价格、平台支持与效果数据暂未提供。