command-creator

命令创建器

创建委托给技能的命令文件。命令位于 .claude/commands/，Claude Code 会自动将其发现为 /commandname。

步骤 0：检查是否已有命令

创建前，检查命令是否已存在：

test -f .claude/commands/<command-name>.md && echo "EXISTS" || echo "NEW"

如果已存在 → 使用 Read 检查当前命令文件，然后使用 Edit 直接应用更改。更新后运行创建后集成步骤（步骤 4）。

如果是新命令 → 继续执行步骤 0.5。

步骤 0.5：配套项检查

开始创建前，运行生态配套项检查：

1. 使用 .claude/lib/creators/companion-check.cjs 中的 companion-check.cjs
2. 调用 checkCompanions("command", "{command-name}")，识别配套构件
3. 查看配套项清单，并记录缺失的必需或推荐配套项
4. 计划在此构件完成后创建或验证缺失的配套项
5. 在创建后集成说明中列出配套项检查结果

此步骤仅供参考（不会阻止创建），但可确保全面考虑整个构件生态。

适用场景

• 为技能创建面向用户的快捷方式
• 简化复杂的技能调用
• 为常见工作流提供易记的命令名称

命令文件格式

所有命令都使用以下模式：

---
description: Brief description of what this command does
disable-model-invocation: true
---

Invoke the {skill-name} skill and follow it exactly as presented to you

示例：/tdd 命令

---
description: Test-driven development workflow with Iron Laws
disable-model-invocation: true
---

Invoke the tdd skill and follow it exactly as presented to you

创建工作流

步骤 1：验证输入

// Validate command name (lowercase, hyphens only)
const commandName = args.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');

// Validate target skill exists
const skillExists = await fileExists(`.claude/skills/**/${args.skill}/SKILL.md`);
if (!skillExists) {
  throw new Error(`Target skill not found: ${args.skill}`);
}

步骤 2：创建命令文件

const commandPath = `.claude/commands/${commandName}.md`;
const description = args.description || `Invoke the ${args.skill} skill`;

const content = `---
description: ${description}
disable-model-invocation: true
---

Invoke the ${args.skill} skill and follow it exactly as presented to you
`;

await writeFile(commandPath, content);

步骤 3：更新命令目录

const catalogPath = '.claude/context/artifacts/catalogs/command-catalog.md';
const catalogContent = await readFile(catalogPath, 'utf-8');

// Add entry to catalog
const newEntry = `| /${commandName} | ${description} | ${args.skill} |`;

// Insert alphabetically

步骤 4：运行创建后集成

const {
  runIntegrationChecklist,
  queueCrossCreatorReview,
} = require('.claude/lib/creators/creator-commons.cjs');

await runIntegrationChecklist('command', commandPath);
await queueCrossCreatorReview('command', commandPath, {
  artifactName: commandName,
  createdBy: 'command-creator',
});

创建后集成

创建命令后，运行集成检查清单：

const {
  runIntegrationChecklist,
  queueCrossCreatorReview,
} = require('.claude/lib/creators/creator-commons.cjs');

// 1. Run integration checklist
const result = await runIntegrationChecklist('command', '.claude/commands/<command-name>.md');

// 2. Queue cross-creator review
await queueCrossCreatorReview('command', '.claude/commands/<command-name>.md', {
  artifactName: '<command-name>',
  createdBy: 'command-creator',
});

// 3. Review impact report
// Check result.mustHave for failures - address before marking complete

集成验证：

• 已将命令添加到 command-catalog.md
• 目标技能存在且有效
• 命令文件包含正确的 YAML 前置元数据
• 可通过 /commandname 发现命令

使用示例

创建 TDD 命令

Skill({
  skill: 'command-creator',
  args: '--name tdd --skill tdd --description "Test-driven development workflow"',
});

创建调试命令

Skill({
  skill: 'command-creator',
  args: '--name debug --skill debugging --description "Systematic debugging workflow"',
});

相关技能

• skill-creator - 创建命令委托调用的技能
• skill-updater - 更新命令委托调用的底层技能

记忆协议（强制）

开始前： 读取 .claude/context/memory/learnings.md

完成后：

• 新命令模式 → .claude/context/memory/learnings.md
• 命令创建问题 → .claude/context/memory/issues.md
• 委托决策 → .claude/context/memory/decisions.md

假设任务可能中断：如果没有记录在记忆中，就说明它没有发生。

交叉引用：创作者生态

此技能属于 创作者生态。研究发现缺口时，请调用相应的配套创建器：

发现的缺口	必需的产物	要调用的创建器	适用情形
领域知识需要转化为可复用的技能	skill	Skill({ skill: 'skill-creator' })	缺口涵盖一个完整的技能领域
现有技能的覆盖范围不完整	skill update	Skill({ skill: 'skill-updater' })	已有相关技能，但内容不完整
某项能力需要专属 Agent	agent	Skill({ skill: 'agent-creator' })	需要由 Agent 负责该能力
现有 Agent 需要更新能力	agent update	Skill({ skill: 'agent-updater' })	已有相关 Agent，但能力不完整
领域需要代码／项目脚手架	template	Skill({ skill: 'template-creator' })	需要可复用的代码模式
行为需要执行前／后的防护机制	hook	Skill({ skill: 'hook-creator' })	需要强制执行行为
流程需要多阶段编排	workflow	Skill({ skill: 'workflow-creator' })	需要多步骤协调
产物需要结构化的 I/O 验证	schema	Skill({ skill: 'schema-creator' })	需要用于产物 I/O 的 JSON schema
用户交互需要斜杠命令	command	Skill({ skill: 'command-creator' })	需要面向用户的快捷方式
重复逻辑需要可复用的 CLI 工具	tool	Skill({ skill: 'tool-creator' })	需要 CLI 实用工具
仅适用于范围狭窄／单一产物的能力	inline	仅在此产物中记录	特定性过强，无法泛化

---

生态对齐契约（强制）

此创建器技能属于协同运作的创作者生态。此处创建的任何产物都必须与相关创建器保持一致，并通过其验证：

• agent-creator：负责归属和执行路径
• skill-creator：负责能力打包和分配
• tool-creator：负责可执行自动化接口
• hook-creator：负责强制执行和防护措施
• rule-creator 和 semgrep-rule-creator：负责策略和静态检查
• template-creator：负责标准化脚手架
• workflow-creator：负责编排和阶段门控
• command-creator：负责面向用户／操作者的命令 UX

跨创建器交接（必需）

完成前，请验证所有相关交接：

1. 产物路由已添加到 .claude/CLAUDE.md 和相关路由文档中。
2. 已更新发现／注册信息（视情况更新目录／索引／注册表）。
3. 已创建配套产物，或明确说明豁免原因。
4. 为所创建的产物运行 validate-integration.cjs 并通过验证。
5. 技能元数据发生变化时，重新生成技能索引。

Research Gate（Exa + arXiv — 两者均为必需）

对于新的模式、模板或工作流，必须进行调研：

1. 使用 Exa 研究实现方式和生态系统模式：
   • mcp__Exa__web_search_exa({ query: '<topic> 2025 best practices' })
   • mcp__Exa__get_code_context_exa({ query: '<topic> implementation examples' })
2. 搜索 arXiv 上的学术研究（AI/ML、Agent、评估、编排、记忆/RAG、安全相关主题均为必需）：
   • 通过 Exa：mcp__Exa__web_search_exa({ query: 'site:arxiv.org <topic> 2024 2025' })
   • 直接调用 API：WebFetch({ url: 'https://arxiv.org/search/?query=<topic>&searchtype=all&start=0' })
3. 在制品引用/文档中记录决策、约束和非目标。
4. 尽量减少更新，避免过度设计。

主题涉及以下内容时，必须搜索 arXiv（不得作为备选）： AI Agent、大模型评估、编排、记忆/RAG、安全、静态分析或任何新兴方法。

安全回归交付

• 行为变更严格遵循 RED -> GREEN -> REFACTOR 流程。
• 针对变更模块运行测试。
• 对变更文件运行 lint/format。
• 按关注点划分提交（逻辑/文档/生成的制品）。