@specpow/framework 0.2.0

package/dist/core/command-generation/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * 命令生成模块 — AI 工具适配层
+ *
+ * P1-9: 重构为统一适配器注册表，支持 14+ AI 工具
+ *
+ * 将 SpecPow 技能/命令转换为各 AI 工具的原生格式：
+ *   - Claude Code → .claude/commands/*.md (namespaced: /specpow:explore)
+ *   - Cursor → .cursor/rules/*.mdc (flat: /specpow-explore)
+ *   - Copilot → .github/copilot-instructions.md (flat: /specpow-explore)
+ *   - CodeBuddy → .codebuddy/rules/*.md
+ *   - Codex → .codex/instructions.md
+ *   - Gemini → .gemini/instructions.md (namespaced: /specpow:explore)
+ *   - Amazon Q → .amazonq/commands/*.md (prefix: @specpow-propose)
+ *   - Cline → .cline/rules/*.md
+ *   - Continue → .continue/config.md
+ *   - Windsurf → .windsurf/rules/*.md
+ *   - Trae → .trae/rules/*.md
+ *   - Kiro → .kiro/steering/*.md
+ *   - Qwen → .qwen/instructions.md
+ *   - Kimi → .kimi/instructions.md
+ */
+/** P1-9: 扩展的 AI 工具类型 */
+export type AITool = 'claude' | 'cursor' | 'copilot' | 'codebuddy' | 'codex' | 'gemini' | 'amazonq' | 'cline' | 'continue' | 'windsurf' | 'trae' | 'kiro' | 'qwen' | 'kimi' | 'copilot-workspace' | 'roo' | 'auggie' | 'bob' | 'crush' | 'devin' | 'junie' | 'qoder';
+/** P1-9: 调用风格 */
+export type InvocationStyle = 'namespaced' | 'flat' | 'prefix';
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    prompt: string;
+    category: 'planning' | 'execution' | 'quality' | 'business';
+}
+export interface ToolAdapter {
+    tool: AITool;
+    installDir: string;
+    /** P1-9: 调用风格（用于生成命令名称） */
+    invocationStyle?: InvocationStyle;
+    installCommands(commands: CommandDefinition[]): void;
+    uninstallCommands(): void;
+}
+/**
+ * 适配器注册表 — 统一管理所有 AI 工具适配器
+ *
+ * 支持动态注册自定义适配器，替代硬编码的 switch-case 工厂函数
+ */
+export declare class AdapterRegistry {
+    private static adapters;
+    /**
+     * 注册适配器
+     */
+    static register(toolId: string, adapterClass: new (projectRoot: string) => ToolAdapter): void;
+    /**
+     * 获取适配器实例
+     */
+    static get(toolId: string, projectRoot: string): ToolAdapter;
+    /**
+     * 列出所有已注册的适配器 ID
+     */
+    static list(): string[];
+    /**
+     * 检查适配器是否已注册
+     */
+    static has(toolId: string): boolean;
+    /**
+     * 获取所有已注册适配器的实例列表
+     */
+    static getAll(projectRoot: string): ToolAdapter[];
+}
+/**
+ * 通用基类：将命令写入独立 Markdown 文件的适配器
+ * 子类只需指定 installDir 和 fileExt
+ */
+declare abstract class MarkdownFileAdapter implements ToolAdapter {
+    abstract tool: AITool;
+    installDir: string;
+    invocationStyle?: InvocationStyle;
+    constructor(projectRoot: string);
+    /** 文件扩展名，默认 '.md' */
+    protected get fileExt(): string;
+    /** 生成文件内容，子类可覆盖以定制格式 */
+    protected formatContent(cmd: CommandDefinition): string;
+    installCommands(commands: CommandDefinition[]): void;
+    uninstallCommands(): void;
+}
+/**
+ * P1-9: 单文件聚合适配器基类
+ * 适用于使用单一文件存放所有命令的工具（如 Codex, Gemini, Qwen, Kimi）
+ */
+declare abstract class SingleFileAdapter implements ToolAdapter {
+    abstract tool: AITool;
+    installDir: string;
+    invocationStyle?: InvocationStyle;
+    protected fileName: string;
+    constructor(projectRoot: string);
+    installCommands(commands: CommandDefinition[]): void;
+    uninstallCommands(): void;
+}
+export declare class ClaudeAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class CursorAdapter implements ToolAdapter {
+    tool: AITool;
+    installDir: string;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+    installCommands(commands: CommandDefinition[]): void;
+    uninstallCommands(): void;
+}
+export declare class CodeBuddyAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    constructor(projectRoot: string);
+}
+export declare class CopilotAdapter implements ToolAdapter {
+    tool: AITool;
+    installDir: string;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+    installCommands(commands: CommandDefinition[]): void;
+    uninstallCommands(): void;
+}
+export declare class CodexAdapter extends SingleFileAdapter {
+    tool: AITool;
+    constructor(projectRoot: string);
+}
+export declare class GeminiAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class CopilotWorkspaceAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class RooAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class AuggieAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class BobAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class CrushAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class DevinAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class JunieAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class QoderAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class AmazonQAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+    /** Amazon Q 使用 @prefix 调用风格 */
+    protected formatContent(cmd: CommandDefinition): string;
+}
+export declare class ClineAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class ContinueAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class WindsurfAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class TraeAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class KiroAdapter extends MarkdownFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+    /** Kiro steering 文件使用特定格式 */
+    protected formatContent(cmd: CommandDefinition): string;
+}
+export declare class QwenAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+export declare class KimiAdapter extends SingleFileAdapter {
+    tool: AITool;
+    invocationStyle: InvocationStyle;
+    constructor(projectRoot: string);
+}
+/**
+ * 根据 AI 工具类型创建对应的适配器
+ * P1-9: 委托给 AdapterRegistry，保持向后兼容
+ */
+export declare function createAdapter(tool: AITool, projectRoot: string): ToolAdapter;
+/**
+ * 从技能目录加载命令定义
+ */
+export declare function loadCommandsFromSkills(skillsDir: string): CommandDefinition[];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/command-generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,wBAAwB;AACxB,MAAM,MAAM,MAAM,GACd,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAClE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAC/D,MAAM,GAAG,MAAM,GACf,mBAAmB,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3F,iBAAiB;AACjB,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;CAC7D;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACrD,iBAAiB,IAAI,IAAI,CAAC;CAC3B;AAID;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+D;IAEtF;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI;IAI7F;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW;IAQ5D;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE;CAIlD;AAID;;;GAGG;AACH,uBAAe,mBAAoB,YAAW,WAAW;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;gBAEtB,WAAW,EAAE,MAAM;IAI/B,qBAAqB;IACrB,SAAS,KAAK,OAAO,IAAI,MAAM,CAAkB;IAEjD,wBAAwB;IACxB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAIvD,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAQpD,iBAAiB,IAAI,IAAI;CAK1B;AAED;;;GAGG;AACH,uBAAe,iBAAkB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,SAAS,CAAC,QAAQ,SAAqB;gBAE3B,WAAW,EAAE,MAAM;IAI/B,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAiBpD,iBAAiB,IAAI,IAAI;CAM1B;AAID,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,IAAI,EAAE,MAAM,CAAY;IACxB,eAAe,EAAE,eAAe,CAAgB;gBAEpC,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,aAAc,YAAW,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAY;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;IAI/B,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAiBpD,iBAAiB,IAAI,IAAI;CAK1B;AAID,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,IAAI,EAAE,MAAM,CAAe;gBAEf,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,cAAe,YAAW,WAAW;IAChD,IAAI,EAAE,MAAM,CAAa;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;IAI/B,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAiBpD,iBAAiB,IAAI,IAAI;CAM1B;AAID,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,IAAI,EAAE,MAAM,CAAW;gBAEX,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,aAAc,SAAQ,iBAAiB;IAClD,IAAI,EAAE,MAAM,CAAY;IACxB,eAAe,EAAE,eAAe,CAAgB;gBAEpC,WAAW,EAAE,MAAM;CAIhC;AAMD,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,IAAI,EAAE,MAAM,CAAuB;IACnC,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,UAAW,SAAQ,mBAAmB;IACjD,IAAI,EAAE,MAAM,CAAS;IACrB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,aAAc,SAAQ,iBAAiB;IAClD,IAAI,EAAE,MAAM,CAAY;IACxB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,UAAW,SAAQ,mBAAmB;IACjD,IAAI,EAAE,MAAM,CAAS;IACrB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,IAAI,EAAE,MAAM,CAAW;IACvB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,IAAI,EAAE,MAAM,CAAW;IACvB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,IAAI,EAAE,MAAM,CAAW;IACvB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,IAAI,EAAE,MAAM,CAAW;IACvB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,cAAe,SAAQ,mBAAmB;IACrD,IAAI,EAAE,MAAM,CAAa;IACzB,eAAe,EAAE,eAAe,CAAY;gBAEhC,WAAW,EAAE,MAAM;IAK/B,+BAA+B;IAC/B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;CASxD;AAID,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,IAAI,EAAE,MAAM,CAAW;IACvB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,IAAI,EAAE,MAAM,CAAc;IAC1B,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAKhC;AAID,qBAAa,eAAgB,SAAQ,mBAAmB;IACtD,IAAI,EAAE,MAAM,CAAc;IAC1B,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,WAAY,SAAQ,mBAAmB;IAClD,IAAI,EAAE,MAAM,CAAU;IACtB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,WAAY,SAAQ,mBAAmB;IAClD,IAAI,EAAE,MAAM,CAAU;IACtB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;IAK/B,6BAA6B;IAC7B,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;CAYxD;AAID,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,IAAI,EAAE,MAAM,CAAU;IACtB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AAID,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,IAAI,EAAE,MAAM,CAAU;IACtB,eAAe,EAAE,eAAe,CAAU;gBAE9B,WAAW,EAAE,MAAM;CAIhC;AA6BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAwC7E"}