第 23 章：斜杠命令与插件系统

// → src/types/command.ts（简化版）
type Command =
  | PromptCommand      // 展开为提示词发给模型
  | LocalCommand       // 非交互式本地命令
  | LocalJsxCommand    // 交互式 JSX 命令（Ink UI）

// → src/commands/init/index.ts（简化版）
const initCommand = {
  type: 'prompt',
  name: 'init',
  description: 'Initialize CLAUDE.md...',
  getPromptForCommand(args) {
    return 'Analyze this project and create a CLAUDE.md file...'
  },
} satisfies Command

// → src/types/command.ts（简化版）
type CommandBase = {
  name: string                    // 命令名（不含 /）
  description: string             // 帮助描述
  aliases?: string[]              // 别名
  isEnabled?(): boolean           // 是否启用
  isHidden?: boolean              // 是否隐藏
  availability?: 'normal' | 'auth' | 'pro'  // 可用性要求
  argumentHint?: string           // 参数提示
  whenToUse?: string              // 使用场景描述
  loadedFrom?: string             // 加载来源
  supportsNonInteractive?: boolean // 是否支持非交互模式
}

// → src/commands.ts（简化版）
const COMMANDS = memoize(() => {
  return [
    help, compact, clear, config, doctor, init,
    login, logout, mcp, model, permissions,
    review, status, bug, vim, memory,
    // ... 更多命令
    // feature-gated 命令
    ...(feature('DAEMON') ? [daemon] : []),
    ...(feature('BRIDGE_MODE') ? [bridge] : []),
  ]
})

// → src/commands.ts（简化版）
function loadAllCommands(context) {
  const all = [
    ...bundledSkills,          // 1. 内置技能
    ...builtinPluginSkills,    // 2. 内置插件技能
    ...skillDirCommands,       // 3. /skills/ 目录
    ...workflowCommands,       // 4. 工作流命令
    ...pluginCommands,         // 5. 插件命令
    ...pluginSkills,           // 6. 插件技能
    ...COMMANDS(),             // 7. 硬编码命令（最低优先级）
  ]

  return all.filter(cmd =>
    meetsAvailabilityRequirement(cmd) &&
    isCommandEnabled(cmd)
  )
}

// → src/types/plugin.ts
type PluginComponent =
  | 'commands'       // 斜杠命令
  | 'agents'         // 代理定义
  | 'skills'         // 技能
  | 'hooks'          // Hook 配置
  | 'output-styles'  // 输出样式

// → src/utils/plugins/schemas.ts（简化版）
type PluginManifest = {
  // 元数据
  name: string
  version: string
  description?: string
  author?: string
  homepage?: string
  repository?: string
  license?: string
  keywords?: string[]
  dependencies?: Record<string, string>

  // 组件
  commands?: string | string[] | Record<string, CommandDef>
  agents?: string | string[]
  skills?: string | string[]
  hooks?: object | string              // Hook 配置
  outputStyles?: string | string[]     // 输出样式
  mcpServers?: McpServerConfig[]       // MCP 服务器
  lspServers?: LspServerConfig[]       // LSP 服务器
  channels?: ChannelConfig[]           // 通知通道
  settings?: Partial<Settings>         // 启用时合并的设置
  userConfig?: UserConfigDef[]         // 用户可配置值
}

// → src/utils/plugins/schemas.ts（简化版）
type PluginSource =
  | string                               // 相对路径
  | { source: 'npm', package, version? }    // npm 包
  | { source: 'pip', package, version? }    // Python 包
  | { source: 'url', url, ref?, sha? }      // URL 下载
  | { source: 'github', repo, ref?, sha? }  // GitHub 仓库
  | { source: 'git-subdir', url, path, ref?, sha? }  // monorepo 子目录

console.log('[DEBUG] Commands:', result.map(c => `${c.type}/${c.name}`).join(', '))
console.log('[DEBUG] Total:', result.length)