Claude-Code-Workflow/.claude/skills/ccw-coordinator/tools

CCW Coordinator Tools

command-registry.cjs

命令注册表工具：获取和提取命令元数据。

功能

• 按需提取: 只提取指定命令的完整信息（name, description, argumentHint, allowedTools 等）
• 全量获取: 获取所有命令的名称和描述（快速查询）
• 自动查找: 从全局 .claude/commands/workflow 目录读取（项目相对路径 > 用户 home）
• 缓存机制: 避免重复读取文件

编程接口

const CommandRegistry = require('./tools/command-registry.cjs');
const registry = new CommandRegistry();

// 1. 获取所有命令的名称和描述（快速）
const allCommands = registry.getAllCommandsSummary();
// {
//   "/workflow:lite-plan": {
//     name: 'lite-plan',
//     description: '轻量级规划...'
//   },
//   "/workflow:lite-execute": { ... }
// }

// 2. 按需提取指定命令的完整信息
const commands = registry.getCommands([
  '/workflow:lite-plan',
  '/workflow:lite-execute'
]);
// {
//   "/workflow:lite-plan": {
//     name: 'lite-plan',
//     description: '...',
//     argumentHint: '[-e|--explore] "task description"',
//     allowedTools: [...],
//     filePath: '...'
//   },
//   ...
// }

命令行接口

# 获取所有命令的名称和描述
node .claude/skills/ccw-coordinator/tools/command-registry.cjs
node .claude/skills/ccw-coordinator/tools/command-registry.cjs --all

# 输出: 23 个命令的简明列表 (name + description)

# 按需提取指定命令的完整信息
node .claude/skills/ccw-coordinator/tools/command-registry.cjs lite-plan lite-execute

# 输出: 完整信息 (name, description, argumentHint, allowedTools, filePath)

集成用途

在 action-command-execute 中使用：

// 1. 初始化时只提取任务链中的命令（完整信息）
const commandNames = command_chain.map(cmd => cmd.command);
const commandMeta = registry.getCommands(commandNames);

// 2. 参数组装时使用 argumentHint
function assembleCommandLine(cmd, state, commandMeta) {
  const cmdInfo = commandMeta[cmd.command];
  let commandLine = cmd.command;  // /workflow:lite-plan

  commandLine += ' --yes';  // 自动确认

  // 根据 argumentHint 智能组装参数
  const cmdName = cmd.command.split(':').pop();
  if (cmdName === 'lite-plan') {
    commandLine += ` "${state.task_description}"`;
  } else if (cmdName === 'lite-execute' && hasPlanResult(state)) {
    commandLine += ' --in-memory';
  }

  return commandLine;
}

// 3. 生成提示词（直接包含完整命令）
function generatePrompt(cmd, state, commandMeta) {
  let prompt = `任务: ${state.task_description}\n`;

  // 添加前序完成
  if (state.execution_results.length > 0) {
    prompt += `\n前序完成:\n${formatResults(state.execution_results)}\n`;
  }

  // 组装完整命令行（关键）
  const commandLine = assembleCommandLine(cmd, state, commandMeta);
  prompt += `\n${commandLine}`;

  return prompt;
}

确保 ccw cli -p "..." 提示词直接包含完整命令调用，而不是准则。

目录查找逻辑

自动查找顺序：

1. .claude/commands/workflow (相对于当前工作目录)
2. ~/.claude/commands/workflow (用户 home 目录)