create

⛔ 创建插件 — 停下并阅读

不要凭假设行事。请先阅读此文件。

这是一个用于在 Claude Code 市场中创建新插件的结构化工作流命令。

你现在唯一要做的第一件事：执行下面的 TodoWrite。

自我演进技能：此技能会在使用中不断改进。如果说明有误、参数发生变化，或需要采取变通方案，请立即修复此文件，不要拖延。只针对真实且可复现的问题进行更新。

⛔ 必须执行的第一步：初始化 TodoWrite

你的第一步必须是执行下面的 TodoWrite 调用。

不要：

• ❌ 在执行 TodoWrite 前创建任何目录
• ❌ 在执行 TodoWrite 前读取 marketplace.json
• ❌ 在执行 TodoWrite 前提问
• ❌ 未完成步骤 0 就直接跳到任何阶段

步骤 0.1：检测市场根目录

在执行 TodoWrite 之前，确认你位于市场目录中：

/usr/bin/env bash << 'PREFLIGHT_EOF'
# Check for marketplace.json in cwd
if [ -f ".claude-plugin/marketplace.json" ]; then
  echo "✅ Marketplace detected: $(jq -r .name .claude-plugin/marketplace.json)"
else
  echo "❌ Not a marketplace directory. Run from a marketplace root."
  exit 1
fi
PREFLIGHT_EOF

步骤 0.2：执行必须的 TodoWrite

现在使用此模板执行 TodoWrite：

TodoWrite with todos:

- "[Plugin] Phase 0: Detect marketplace root" | in_progress
- "[Plugin] Phase 0: Interactive prompts (name, category, components)" | pending
- "[Plugin] Phase 0: Confirm plugin doesn't exist" | pending
- "[Plugin] Phase 1: Skill → plugin-structure (scaffold)" | pending
- "[Plugin] Phase 1: Create plugin directory + plugin.json" | pending
- "[Plugin] Phase 1: Skill → implement-plan-preflight (ADR)" | pending
- "[Plugin] Phase 2: Skill → skill-architecture (if has-skills)" | pending
- "[Plugin] Phase 2: Skill → hook-development (if has-hooks)" | pending
- "[Plugin] Phase 2: Skill → command-development (if has-commands)" | pending
- "[Plugin] Phase 2: Skill → agent-development (if has-agents)" | pending
- "[Plugin] Phase 2: Agent → skill-reviewer (if skills created)" | pending
- "[Plugin] Phase 3: Add to marketplace.json" | pending
- "[Plugin] Phase 3: Run validate-plugins.mjs" | pending
- "[Plugin] Phase 3: Skill → code-hardcode-audit" | pending
- "[Plugin] Phase 3: Agent → plugin-validator" | pending
- "[Plugin] Phase 4: Git commit (conventional format)" | pending
- "[Plugin] Phase 4: Push to remote" | pending
- "[Plugin] Phase 4: Skill → semantic-release" | pending

TodoWrite 完成后，继续阅读下面的阶段 0 部分。

---

快速参考

调用的技能（优化顺序）

顺序	技能	阶段	用途	调用方式
1	plugin-structure	1	目录与清单	Skill(plugin-dev:plugin-structure)
2	implement-plan-preflight	1	ADR + 设计规范 + 图表	Skill(itp:implement-plan-preflight)
3	skill-architecture	2	创建技能（如果包含技能）	Skill(plugin-dev:skill-architecture)
4	hook-development	2	创建钩子（如果包含钩子）	Skill(plugin-dev:hook-development)
5	command-development	2	创建命令（如果包含命令）	Skill(plugin-dev:command-development)
6	agent-development	2	创建 Agent（如果包含 Agent）	Skill(plugin-dev:agent-development)
7	code-hardcode-audit	3	质量审计	Skill(itp:code-hardcode-audit)
8	plugin-validator	3	静默失败审计	Skill(plugin-dev:plugin-validator)
9	release-full	4	运行仓库的发布流水线	moon run repo:release-full

排除的技能（冗余）

技能	排除原因
plugin-dev:skill-development	改用 skill-architecture（全面程度高出 3 倍）
plugin-dev:plugin-settings	已并入 hook-development

启动的 Agent

阶段	Agent	用途	调用方式
2	skill-reviewer	审查技能质量	Task(plugin-dev:skill-reviewer)
3	plugin-validator	验证最终结构	Task(plugin-dev:plugin-validator)

文件位置

构件	路径	备注
插件目录	plugins/{name}/	主插件文件夹
插件清单	plugins/{name}/plugin.json	必需的清单
插件 README	plugins/{name}/README.md	文档
Marketplace JSON	.claude-plugin/marketplace.json	必须添加插件条目
ADR	docs/adr/YYYY-MM-DD-{name}.md	由 preflight 技能创建
设计规范	docs/design/YYYY-MM-DD-{name}/spec.md	由 preflight 技能创建

---

阶段 0：发现与验证

检测 Marketplace 根目录，通过交互式提示收集插件名称、类别和组件，并确认插件尚不存在。

详细步骤：阶段 0 参考

阶段 0 检查关卡

• 已检测到 Marketplace 根目录（.claude-plugin/marketplace.json 存在）
• 已收集插件名称（kebab-case，不含空格）
• 已选择类别
• 已选择组件（skills/hooks/commands/agents）
• 插件目录不存在
• 插件不在 marketplace.json 中

---

阶段 1：搭建插件框架

1. 调用 Skill(plugin-dev:plugin-structure) —— 目录和清单模式
2. 创建插件目录，根据用户的选择创建组件子目录
3. 生成 plugin.json，使用 Marketplace 版本
4. 调用 Skill(itp:implement-plan-preflight) —— 创建 ADR、设计规范和图表

详细步骤：阶段 1 参考

阶段 1 检查关卡

• 插件目录存在：plugins/$PLUGIN_NAME/
• 已使用 Marketplace 版本创建 plugin.json
• ADR 存在：docs/adr/$ADR_ID.md
• 设计规范存在：docs/design/$ADR_ID/spec.md
• ADR 中包含两个图表（Before/After + Architecture）

---

阶段 2：创建组件（有条件）

仅执行用户所选组件对应的技能：

组件	技能调用	然后
Skills	Skill(plugin-dev:skill-architecture)	启动 Task(plugin-dev:skill-reviewer)
Hooks	Skill(plugin-dev:hook-development)	--
Commands	Skill(plugin-dev:command-development)	--
Agents	Skill(plugin-dev:agent-development)	--

详细步骤：阶段 2 参考

阶段 2 检查关卡

• 已创建所有选定的组件
• 如果包含 skills：skill-reviewer Agent 已完成审查
• 文件遵循 plugin-dev 模式

---

阶段 3：注册与验证

1. 将插件添加到 marketplace.json（如果存在 hooks，则包含 hooks 字段）
2. 运行 node scripts/validate-plugins.mjs —— 预期全部通过
3. 调用 Skill(itp:code-hardcode-audit) —— 质量审计
4. 对所有 hook 入口点运行静默失败审计
5. 启动 Task(plugin-dev:plugin-validator) —— 结构验证

详细步骤：阶段 3 参考

阶段 3 检查关卡

• 插件已添加到 marketplace.json
• validate-plugins.mjs 通过
• code-hardcode-audit 通过
• silent-failure-audit 通过（无错误）
• plugin-validator Agent 已批准

---

阶段 4：提交与发布

1. 暂存更改：插件目录、marketplace.json、ADR、设计规范
2. Conventional commit：feat($PLUGIN_NAME): add plugin for [brief description]
3. 推送到远程仓库
4. 运行 moon run repo:release-full —— 仓库的发布流水线：打标签、生成变更日志、发布 GitHub 版本

详细步骤：阶段 4 参考

第 4 阶段成功标准

• 所有更改均已使用约定式提交提交
• 已推送到远程仓库
• semantic-release 已完成
• 已创建新版本标签
• 已发布 GitHub 版本

故障排除

常见问题及解决方法请参阅故障排除参考。

执行后反思

此技能完成后，在结束任务前进行反思：

0. 定位自身。 — 在编辑前，找到此 SKILL.md 的规范路径（使用 Glob 搜索此技能的名称）。所有修正都针对此文件及其同级的 references/ — 绝不修改其他文档。
1. 哪些环节失败了？ — 修正导致问题的指令。如果问题可能再次发生，将其列为反模式。
2. 哪些做法比预期更有效？ — 将其提升为推荐实践，并记录原因。
3. 哪些内容出现了偏差？ — 如果脚本、参考资料或外部依赖与实际情况不再一致，请立即修正。
4. 记录下来。 — 每项更改都要在演进日志中记录触发原因、修正内容和证据。

不要延后处理。下一次调用会继承你留下的一切。

---

---