@zhuan-ai/zhuanspec 2.2.4 → 2.4.8

package/dist/commands/validate.js

@@ -21,7 +21,7 @@ export class ValidateCommand {
         // No item and no flags
         if (!itemName) {
             if (interactive) {
-                await this.runInteractiveSelector({ strict: !!options.strict, json: !!options.json, concurrency: options.concurrency });
+                await this.runInteractiveSelector({ strict: !!options.strict, json: !!options.json, concurrency: options.concurrency, autoFix: !!options.autoFix });
                 return;
             }
             this.printNonInteractiveHint();
@@ -30,7 +30,7 @@ export class ValidateCommand {
         }
         // Direct item validation with type detection or override
         const typeOverride = this.normalizeType(options.type);
-        await this.validateDirectItem(itemName, { typeOverride, strict: !!options.strict, json: !!options.json });
+        await this.validateDirectItem(itemName, { typeOverride, strict: !!options.strict, json: !!options.json, autoFix: !!options.autoFix });
     }
     normalizeType(value) {
         if (!value)
@@ -101,24 +101,64 @@ export class ValidateCommand {
     }
     async validateByType(type, id, opts) {
         const validator = new Validator(opts.strict);
+        const MAX_AUTO_FIX_ATTEMPTS = 3;
         if (type === 'change') {
             const changeDir = path.join(process.cwd(), 'zhuanspec', 'changes', id);
+            // Auto-fix loop
+            let attempt = 0;
+            let report;
+            while (attempt < MAX_AUTO_FIX_ATTEMPTS) {
+                const start = Date.now();
+                report = await validator.validateChangeDeltaSpecs(changeDir);
+                // Validate tasks.md dependencies if present
+                const taskReport = await this.validateTaskDependencies(changeDir);
+                // Merge task dependency issues into report
+                if (taskReport.issues.length > 0) {
+                    report.issues.push(...taskReport.issues);
+                    report.valid = report.valid && taskReport.valid;
+                }
+                // Write Mermaid diagram to tasks.md if generated
+                if (report.mermaidDiagram) {
+                    await this.writeMermaidDiagramToTasks(changeDir, report.mermaidDiagram);
+                }
+                const durationMs = Date.now() - start;
+                // If valid or no auto-fix, break the loop
+                if (report.valid || !opts.autoFix) {
+                    this.printReport('change', id, report, durationMs, opts.json, taskReport, { strict: opts.strict });
+                    process.exitCode = report.valid ? 0 : 1;
+                    return;
+                }
+                // Auto-fix attempt
+                attempt++;
+                if (!opts.json) {
+                    console.log(`Auto-fix attempt ${attempt}/${MAX_AUTO_FIX_ATTEMPTS}...`);
+                }
+                // Try to fix common issues
+                const fixed = await this.tryAutoFix(changeDir, report.issues);
+                if (!fixed) {
+                    // No fixes applied, break the loop
+                    this.printReport('change', id, report, durationMs, opts.json, taskReport, { strict: opts.strict });
+                    if (!opts.json) {
+                        console.error(`Auto-fix failed after ${attempt} attempts. Manual intervention required.`);
+                    }
+                    process.exitCode = 1;
+                    return;
+                }
+                // Fixes applied, continue loop to re-validate
+            }
+            // Max attempts reached
             const start = Date.now();
-            const report = await validator.validateChangeDeltaSpecs(changeDir);
-            // Validate tasks.md dependencies if present
+            report = await validator.validateChangeDeltaSpecs(changeDir);
             const taskReport = await this.validateTaskDependencies(changeDir);
-            // Merge task dependency issues into report
             if (taskReport.issues.length > 0) {
                 report.issues.push(...taskReport.issues);
                 report.valid = report.valid && taskReport.valid;
             }
-            // Write Mermaid diagram to tasks.md if generated
-            if (report.mermaidDiagram) {
-                await this.writeMermaidDiagramToTasks(changeDir, report.mermaidDiagram);
-            }
             const durationMs = Date.now() - start;
             this.printReport('change', id, report, durationMs, opts.json, taskReport, { strict: opts.strict });
-            // Non-zero exit if invalid (keeps enriched output test semantics)
+            if (!opts.json && !report.valid) {
+                console.error(`Auto-fix failed after ${MAX_AUTO_FIX_ATTEMPTS} attempts. Manual intervention required.`);
+            }
             process.exitCode = report.valid ? 0 : 1;
             return;
         }
@@ -129,6 +169,117 @@ export class ValidateCommand {
         this.printReport('spec', id, report, durationMs, opts.json, undefined, { strict: opts.strict });
         process.exitCode = report.valid ? 0 : 1;
     }
+    /**
+     * Attempt to auto-fix common validation issues.
+     * Returns true if any fixes were applied.
+     */
+    async tryAutoFix(changeDir, issues) {
+        let fixed = false;
+        for (const issue of issues) {
+            // Skip non-ERROR issues
+            if (issue.level !== 'ERROR')
+                continue;
+            // 1. Missing proposal section - add skeleton
+            if (issue.message.includes('Proposal 缺少必需章节')) {
+                const sectionMatch = issue.message.match(/缺少必需章节[：:]\s*(.+)/);
+                if (sectionMatch) {
+                    const sectionName = sectionMatch[1];
+                    await this.addProposalSectionSkeleton(changeDir, sectionName);
+                    fixed = true;
+                }
+                continue;
+            }
+            // 2. Missing review gate - add to tasks.md
+            if (issue.message.includes('review gate') || issue.message.includes('zhuanspec review')) {
+                await this.addReviewGateToTasks(changeDir);
+                fixed = true;
+                continue;
+            }
+            // 4. Missing @skill tag - add @skill:none (existing logic)
+            if (issue.message.includes('Skill Mapping') || issue.message.includes('@skill')) {
+                const tasksFile = path.join(changeDir, 'tasks.md');
+                try {
+                    const content = await fs.readFile(tasksFile, 'utf-8');
+                    const lines = content.split('\n');
+                    const newLines = lines.map(line => {
+                        // If line is a task checkbox without @skill, add @skill:none
+                        if (line.match(/^- \[ \] \d+\.\d+/) && !line.includes('@skill:')) {
+                            return line + ' @skill:none';
+                        }
+                        return line;
+                    });
+                    const newContent = newLines.join('\n');
+                    if (newContent !== content) {
+                        await fs.writeFile(tasksFile, newContent, 'utf-8');
+                        fixed = true;
+                    }
+                }
+                catch {
+                    // Cannot read/write tasks.md
+                }
+                continue;
+            }
+            // 5. Wave ordering issues - cannot auto-fix (needs manual review)
+            if (issue.message.includes('appears after tasks of wave') || issue.message.includes('Wave headers')) {
+                // This requires understanding the full task structure - manual fix required
+                continue;
+            }
+            // 6. Missing scenario - cannot auto-fix (needs content)
+            if (issue.message.includes('must have at least one scenario')) {
+                continue;
+            }
+        }
+        return fixed;
+    }
+    /**
+     * Add a section skeleton to proposal.md
+     */
+    async addProposalSectionSkeleton(changeDir, sectionName) {
+        const proposalPath = path.join(changeDir, 'proposal.md');
+        try {
+            let content = await fs.readFile(proposalPath, 'utf-8');
+            const skeletons = {
+                'Why/变更原因': '\n\n## 变更原因\n\n[待补充：问题背景、解决动机]\n',
+                'What Changes/变更内容': '\n\n## 变更内容\n\n- [待补充：具体改动点]\n',
+                'Impact/影响范围': '\n\n## 影响范围\n\n- Affected specs: [待补充]\n- Affected code: [待补充]\n',
+            };
+            // Try to match the section name
+            let skeleton = skeletons[sectionName];
+            if (!skeleton) {
+                // Try partial match
+                for (const key of Object.keys(skeletons)) {
+                    if (sectionName.includes(key.split('/')[0]) || sectionName.includes(key.split('/')[1])) {
+                        skeleton = skeletons[key];
+                        break;
+                    }
+                }
+            }
+            if (!skeleton) {
+                skeleton = `\n\n## ${sectionName}\n\n[待补充]\n`;
+            }
+            content = content.trimEnd() + skeleton;
+            await fs.writeFile(proposalPath, content, 'utf-8');
+        }
+        catch {
+            // Cannot read/write proposal.md
+        }
+    }
+    /**
+     * Add review gate section to tasks.md
+     */
+    async addReviewGateToTasks(changeDir) {
+        const tasksPath = path.join(changeDir, 'tasks.md');
+        try {
+            let content = await fs.readFile(tasksPath, 'utf-8');
+            if (!content.includes('zhuanspec review') && !content.includes('审查门禁')) {
+                content = content.trimEnd() + '\n\n## 审查门禁\n\n- [ ] 执行 `zhuanspec review <change-id>` 并确认通过\n';
+                await fs.writeFile(tasksPath, content, 'utf-8');
+            }
+        }
+        catch {
+            // Cannot read/write tasks.md
+        }
+    }
     printReport(type, id, report, durationMs, json, taskReport, opts) {
         if (json) {
             const out = {

package/dist/core/archive.d.ts

@@ -31,6 +31,7 @@ export declare class ArchiveCommand {
     private hasGitChanges;
     private copyDirectoryContentsIfExists;
     private mirrorDirectory;
+    private directoryExists;
     private findFirstDirectoryByName;
     private resolveBusinessTemplateRoot;
     private resolveRemoteBusinessRoot;

package/dist/core/archive.js

@@ -7,6 +7,8 @@ import { getTaskProgressForChange, formatTaskStatus } from '../utils/task-progre
 import { Validator } from './validation/validator.js';
 import chalk from 'chalk';
 import { findSpecUpdates, buildUpdatedSpec, writeUpdatedSpec, } from './specs-apply.js';
+import { preArchiveHook } from './hooks/pre-archive.js';
+import { postArchiveHook } from './hooks/post-archive.js';
 const ARCH_REPO_URL = 'http://gitlab.zhuanspirit.com/zz-kf/spec_repo.git';
 const ARCH_REPO_BRANCH = 'spec_repo-feature-6612-2';
 export class ArchiveCommand {
@@ -27,6 +29,7 @@ export class ArchiveCommand {
         if (!businessDirection) {
             throw new Error('未解析到业务方向，无法执行归档前拉取与归档后回推。请使用 --business-direction 或在 zhuanspec/.business-direction、zhuanspec/project.md 中配置。');
         }
+        console.log(chalk.gray(`业务方向：${businessDirection}`));
         await this.refreshBusinessTemplateFromRemote(zhuanspecDir, businessDirection);
         // Get change name interactively if not provided
         if (!changeName) {
@@ -153,6 +156,8 @@ export class ArchiveCommand {
                 console.log(`警告：发现 ${incompleteTasks} 个未完成的任务。由于 --yes 标志，继续执行。`);
             }
         }
+        // Single source of truth for archive gate: preArchiveHook (review/tests/spec-code consistency)
+        await preArchiveHook({ change: changeName, json: false });
         // Handle spec updates unless skipSpecs flag is set
         if (options.skipSpecs) {
             console.log('跳过规范更新（已提供 --skip-specs 标志）。');
@@ -245,7 +250,17 @@ export class ArchiveCommand {
             await this.moveDirectory(changeDir, archivePath);
             console.log(`变更 '${changeName}' 已归档为 '${archiveName}'。`);
         }
+        // Run post-archive hook (knowledge collection) before pushing to remote
+        console.log(chalk.cyan('\n━━━ 知识收集 ━━━'));
+        await postArchiveHook({ archived: archiveName, json: false });
+        // Push archive result (specs + archive + knowledge) to remote
+        console.log(chalk.cyan('\n━━━ 推送到远端 ━━━'));
         await this.pushArchiveResultToRemote(zhuanspecDir, businessDirection);
+        // Output feedback link after archive completes
+        console.log(chalk.cyan('\n━━━ 使用反馈 ━━━'));
+        console.log(chalk.yellow('  请填写使用反馈，帮助我们改进 ZhuanSpec 工作流：'));
+        console.log(chalk.blue('  📋 https://doc.weixin.qq.com/forms/AJ4AfQfgAAwACwAAwaVABsCNqDXIKn8sf'));
+        console.log(chalk.green('\n✅ 归档完成！'));
     }
     /**
      * Move a directory, falling back to copy+remove when rename fails
@@ -486,8 +501,11 @@ export class ArchiveCommand {
         return null;
     }
     async refreshBusinessTemplateFromRemote(zhuanspecDir, businessDirection) {
+        console.log(chalk.cyan('\n━━━ 拉取远端模板 ━━━'));
+        console.log(chalk.gray('  → 克隆远端模板仓库...'));
         const tempRepo = this.cloneRemoteRepoToTemp();
         try {
+            console.log(chalk.gray('  → 解析远端业务目录...'));
             const remoteBusiness = this.resolveRemoteBusinessRoot(tempRepo, businessDirection);
             if (!remoteBusiness) {
                 throw new Error(`未在远端 specs 目录中找到业务方向 '${businessDirection}'，归档已中止。`);
@@ -497,17 +515,21 @@ export class ArchiveCommand {
             if (!templateRoot) {
                 throw new Error(`未在业务方向 '${businessDirection}' 目录下递归找到可用的 zhuanspec 目录，归档已中止。`);
             }
+            console.log(chalk.gray('  → 同步 specs 目录...'));
             await this.copyDirectoryContentsIfExists(path.join(templateRoot, 'specs'), path.join(zhuanspecDir, 'specs'));
+            console.log(chalk.gray('  → 同步 changes 目录...'));
             await this.copyDirectoryContentsIfExists(path.join(templateRoot, 'changes'), path.join(zhuanspecDir, 'changes'));
-            console.log(chalk.gray(`已拉取 ${businessDirection} 业务模板（specs/changes）。`));
+            console.log(chalk.green(`✅ 已拉取 ${businessDirection} 业务模板（specs/changes）。`));
         }
         finally {
             rmSync(tempRepo, { recursive: true, force: true });
         }
     }
     async pushArchiveResultToRemote(zhuanspecDir, businessDirection) {
+        console.log(chalk.gray('  → 克隆远端模板仓库...'));
         const tempRepo = this.cloneRemoteRepoToTemp();
         try {
+            console.log(chalk.gray('  → 解析远端业务目录...'));
             const remoteBusiness = this.resolveRemoteBusinessRoot(tempRepo, businessDirection);
             if (!remoteBusiness) {
                 throw new Error(`未在远端 specs 目录中找到业务方向 '${businessDirection}'，归档结果回推已中止。`);
@@ -520,20 +542,31 @@ export class ArchiveCommand {
             const remoteBase = templateRoot;
             const remoteSpecsPath = path.join(remoteBase, 'specs');
             const remoteArchivePath = path.join(remoteBase, 'changes', 'archive');
+            const remoteKnowledgePath = path.join(remoteBase, 'knowledge');
             const localSpecsPath = path.join(zhuanspecDir, 'specs');
             const localArchivePath = path.join(zhuanspecDir, 'changes', 'archive');
+            const localKnowledgePath = path.join(zhuanspecDir, 'knowledge');
+            console.log(chalk.gray('  → 同步 specs 目录...'));
             await this.mirrorDirectory(localSpecsPath, remoteSpecsPath);
+            console.log(chalk.gray('  → 同步 archive 目录...'));
             await this.mirrorDirectory(localArchivePath, remoteArchivePath);
+            // Knowledge directory may not exist on first archive, sync only if exists
+            if (await this.directoryExists(localKnowledgePath)) {
+                console.log(chalk.gray('  → 同步 knowledge 目录...'));
+                await this.mirrorDirectory(localKnowledgePath, remoteKnowledgePath);
+            }
             const changed = this.hasGitChanges(tempRepo);
             if (!changed) {
                 console.log(chalk.gray('远端模板仓库无变更，跳过 push。'));
                 return;
             }
+            console.log(chalk.gray('  → 提交变更...'));
             this.git(tempRepo, 'git add .');
-            const commitMsg = `chore: sync archive outputs for ${businessDirection}`;
+            const commitMsg = `chore: sync archive outputs (specs/archive/knowledge) for ${businessDirection}`;
             this.git(tempRepo, `git commit -m "${commitMsg}"`);
+            console.log(chalk.gray('  → 推送到远端...'));
             this.git(tempRepo, `git push origin ${ARCH_REPO_BRANCH}`);
-            console.log(chalk.green(`已推送归档结果到远端 ${ARCH_REPO_BRANCH}（${businessDirection}）。`));
+            console.log(chalk.green(`✅ 已推送归档结果到远端 ${ARCH_REPO_BRANCH}（${businessDirection}）。`));
         }
         finally {
             rmSync(tempRepo, { recursive: true, force: true });
@@ -599,6 +632,15 @@ export class ArchiveCommand {
         await fs.mkdir(path.dirname(targetDir), { recursive: true });
         await fs.cp(sourceDir, targetDir, { recursive: true, force: true });
     }
+    async directoryExists(dirPath) {
+        try {
+            const stat = await fs.stat(dirPath);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
     findFirstDirectoryByName(searchRoot, targetName) {
         if (!existsSync(searchRoot)) {
             return null;

package/dist/core/completions/command-registry.js

@@ -69,6 +69,73 @@ export const COMMAND_REGISTRY = [
         description: 'Display an interactive dashboard of specs and changes',
         flags: [],
     },
+    {
+        name: 'techDesign',
+        description: 'Prepare technical design generation request (techDesign phase, independent before proposal by default)',
+        acceptsPositional: true,
+        positionalType: 'change-id',
+        flags: [
+            {
+                name: 'change',
+                description: 'Optionally bind generated design source to a change',
+                takesValue: true,
+            },
+            {
+                name: 'desc',
+                description: 'Requirement description used for technical design generation',
+                takesValue: true,
+            },
+            {
+                name: 'dashen-page-id',
+                description: 'Dashen pageId used as requirement source',
+                takesValue: true,
+            },
+            {
+                name: 'dashen-url',
+                description: 'Dashen document URL used as requirement source',
+                takesValue: true,
+            },
+            {
+                name: 'output',
+                description: 'Output path of generated request markdown',
+                takesValue: true,
+            },
+            {
+                name: 'init-template',
+                description: 'Generate empty design.md template inside a change (legacy mode)',
+            },
+            {
+                name: 'force',
+                description: 'Overwrite existing output file or bound design.md',
+            },
+        ],
+    },
+    {
+        name: 'design',
+        description: 'Deprecated alias of techDesign',
+        acceptsPositional: true,
+        positionalType: 'change-id',
+        flags: [],
+    },
+    {
+        name: 'review',
+        description: 'Run ZhuanSpec review and unit test verification',
+        acceptsPositional: true,
+        positionalType: 'change-id',
+        flags: [
+            COMMON_FLAGS.json,
+            {
+                name: 'test-command',
+                description: 'Test command to execute (default: npm test)',
+                takesValue: true,
+            },
+            {
+                name: 'coverage-threshold',
+                description: 'Coverage threshold percentage',
+                takesValue: true,
+            },
+        ],
+    },
     {
         name: 'validate',
         description: 'Validate changes and specs',

package/dist/core/configurators/slash/amazon-q.js

@@ -1,8 +1,11 @@
 import { SlashCommandConfigurator } from './base.js';
 const FILE_PATHS = {
     proposal: '.amazonq/prompts/zhuanspec-proposal.md',
+    design: '.amazonq/prompts/zhuanspec-design.md',
     apply: '.amazonq/prompts/zhuanspec-apply.md',
-    archive: '.amazonq/prompts/zhuanspec-archive.md'
+    review: '.amazonq/prompts/zhuanspec-review.md',
+    archive: '.amazonq/prompts/zhuanspec-archive.md',
+    knowledge: '.amazonq/prompts/zhuanspec-knowledge.md'
 };
 const FRONTMATTER = {
     proposal: `---
@@ -14,12 +17,30 @@ The user has requested the following change proposal. Use the zhuanspec instruct
 <UserRequest>
   $ARGUMENTS
 </UserRequest>`,
+    design: `---
+description: 在 proposal 之前独立生成技术设计请求文档。
+---
+
+The user wants to generate a technical design request. Use the zhuanspec instructions to create the design document.
+
+<Input>
+  $ARGUMENTS
+</Input>`,
     apply: `---
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。
 ---
 
 The user wants to apply the following change. Use the zhuanspec instructions to implement the approved change.
 
+<ChangeId>
+  $ARGUMENTS
+</ChangeId>`,
+    review: `---
+description: 在归档前执行代码审查和单元测试验证。
+---
+
+The user wants to review the following change. Use the zhuanspec instructions to run code review and unit test verification.
+
 <ChangeId>
   $ARGUMENTS
 </ChangeId>`,
@@ -31,7 +52,16 @@ The user wants to archive the following deployed change. Use the zhuanspec instr
 
 <ChangeId>
   $ARGUMENTS
-</ChangeId>`
+</ChangeId>`,
+    knowledge: `---
+description: 管理项目知识库（最佳实践、陷阱、隐式约定）。
+---
+
+The user wants to manage the project knowledge base. Use the zhuanspec instructions to view, add, search, or sync knowledge entries.
+
+<Operation>
+  $ARGUMENTS
+</Operation>`
 };
 export class AmazonQSlashCommandConfigurator extends SlashCommandConfigurator {
     toolId = 'amazon-q';

package/dist/core/configurators/slash/antigravity.js

@@ -1,13 +1,19 @@
 import { SlashCommandConfigurator } from './base.js';
 const FILE_PATHS = {
     proposal: '.agent/workflows/zhuanspec-proposal.md',
+    design: '.agent/workflows/zhuanspec-design.md',
     apply: '.agent/workflows/zhuanspec-apply.md',
-    archive: '.agent/workflows/zhuanspec-archive.md'
+    review: '.agent/workflows/zhuanspec-review.md',
+    archive: '.agent/workflows/zhuanspec-archive.md',
+    knowledge: '.agent/workflows/zhuanspec-knowledge.md'
 };
 const DESCRIPTIONS = {
     proposal: '搭建新的 ZhuanSpec 变更并严格验证。',
+    design: '在 proposal 之前独立生成技术设计请求文档。',
     apply: '实施已批准的 ZhuanSpec 变更并保持任务同步。',
-    archive: '归档已部署的 ZhuanSpec 变更并更新规范。'
+    review: '在归档前执行代码审查和单元测试验证。',
+    archive: '归档已部署的 ZhuanSpec 变更并更新规范。',
+    knowledge: '管理项目知识库（最佳实践、陷阱、隐式约定）。'
 };
 export class AntigravitySlashCommandConfigurator extends SlashCommandConfigurator {
     toolId = 'antigravity';

package/dist/core/configurators/slash/auggie.js

@@ -1,21 +1,36 @@
 import { SlashCommandConfigurator } from './base.js';
 const FILE_PATHS = {
     proposal: '.augment/commands/zhuanspec-proposal.md',
+    design: '.augment/commands/zhuanspec-design.md',
     apply: '.augment/commands/zhuanspec-apply.md',
-    archive: '.augment/commands/zhuanspec-archive.md'
+    review: '.augment/commands/zhuanspec-review.md',
+    archive: '.augment/commands/zhuanspec-archive.md',
+    knowledge: '.augment/commands/zhuanspec-knowledge.md'
 };
 const FRONTMATTER = {
     proposal: `---
 description: 搭建新的 ZhuanSpec 变更并严格验证。
 argument-hint: feature description or request
+---`,
+    design: `---
+description: 在 proposal 之前独立生成技术设计请求文档。
+argument-hint: dashen-page-id or description
 ---`,
     apply: `---
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。
 argument-hint: change-id
+---`,
+    review: `---
+description: 在归档前执行代码审查和单元测试验证。
+argument-hint: change-id
 ---`,
     archive: `---
 description: 归档已部署的 ZhuanSpec 变更并更新规范。
 argument-hint: change-id
+---`,
+    knowledge: `---
+description: 管理项目知识库（最佳实践、陷阱、隐式约定）。
+argument-hint: operation (view, add, search, sync)
 ---`
 };
 export class AuggieSlashCommandConfigurator extends SlashCommandConfigurator {

package/dist/core/configurators/slash/base.js

@@ -1,7 +1,7 @@
 import { FileSystemUtils } from '../../../utils/file-system.js';
 import { TemplateManager } from '../../templates/index.js';
 import { ZHUANSPEC_MARKERS } from '../../config.js';
-const ALL_COMMANDS = ['proposal', 'apply', 'archive'];
+const ALL_COMMANDS = ['proposal', 'design', 'apply', 'review', 'archive', 'knowledge'];
 export class SlashCommandConfigurator {
     getTargets() {
         return ALL_COMMANDS.map((id) => ({

package/dist/core/configurators/slash/claude.d.ts

@@ -5,5 +5,9 @@ export declare class ClaudeSlashCommandConfigurator extends SlashCommandConfigur
     readonly isAvailable = true;
     protected getRelativePath(id: SlashCommandId): string;
     protected getFrontmatter(id: SlashCommandId): string;
+    generateAll(projectPath: string, zhuanspecDir: string): Promise<string[]>;
+    updateExisting(projectPath: string, zhuanspecDir: string): Promise<string[]>;
+    private migrateLegacyDesignCommand;
+    private removeLegacyDesignCommand;
 }
 //# sourceMappingURL=claude.d.ts.map

package/dist/core/configurators/slash/claude.js

@@ -1,8 +1,14 @@
 import { SlashCommandConfigurator } from './base.js';
+import { FileSystemUtils } from '../../../utils/file-system.js';
+import { ZHUANSPEC_MARKERS } from '../../config.js';
+import { promises as fs } from 'fs';
 const FILE_PATHS = {
     proposal: '.claude/commands/zhuanspec/proposal.md',
+    design: '.claude/commands/zhuanspec/techDesign.md',
     apply: '.claude/commands/zhuanspec/apply.md',
-    archive: '.claude/commands/zhuanspec/archive.md'
+    review: '.claude/commands/zhuanspec/review.md',
+    archive: '.claude/commands/zhuanspec/archive.md',
+    knowledge: '.claude/commands/zhuanspec/knowledge.md'
 };
 const FRONTMATTER = {
     proposal: `---
@@ -10,18 +16,36 @@ name: ZhuanSpec: Proposal
 description: 搭建新的 ZhuanSpec 变更并严格验证。
 category: ZhuanSpec
 tags: [zhuanspec, change]
+---`,
+    design: `---
+name: ZhuanSpec: TechDesign
+description: 在 proposal 之前独立生成技术设计请求文档。
+category: ZhuanSpec
+tags: [zhuanspec, techDesign, tech-spec]
 ---`,
     apply: `---
 name: ZhuanSpec: Apply
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。
 category: ZhuanSpec
 tags: [zhuanspec, apply]
+---`,
+    review: `---
+name: ZhuanSpec: Review
+description: 在归档前执行代码审查和单元测试验证。
+category: ZhuanSpec
+tags: [zhuanspec, review, code-review]
 ---`,
     archive: `---
 name: ZhuanSpec: Archive
 description: 归档已部署的 ZhuanSpec 变更并更新规范。
 category: ZhuanSpec
 tags: [zhuanspec, archive]
+---`,
+    knowledge: `---
+name: ZhuanSpec: Knowledge
+description: 管理项目知识库（最佳实践、陷阱、隐式约定）。
+category: ZhuanSpec
+tags: [zhuanspec, knowledge]
 ---`
 };
 export class ClaudeSlashCommandConfigurator extends SlashCommandConfigurator {
@@ -33,5 +57,36 @@ export class ClaudeSlashCommandConfigurator extends SlashCommandConfigurator {
     getFrontmatter(id) {
         return FRONTMATTER[id];
     }
+    async generateAll(projectPath, zhuanspecDir) {
+        const createdOrUpdated = await super.generateAll(projectPath, zhuanspecDir);
+        await this.removeLegacyDesignCommand(projectPath);
+        return createdOrUpdated;
+    }
+    async updateExisting(projectPath, zhuanspecDir) {
+        const updated = await super.updateExisting(projectPath, zhuanspecDir);
+        await this.migrateLegacyDesignCommand(projectPath);
+        return updated;
+    }
+    async migrateLegacyDesignCommand(projectPath) {
+        const legacyPath = FileSystemUtils.joinPath(projectPath, '.claude/commands/zhuanspec/design.md');
+        const nextPath = FileSystemUtils.joinPath(projectPath, '.claude/commands/zhuanspec/techDesign.md');
+        if (!await FileSystemUtils.fileExists(legacyPath)) {
+            return;
+        }
+        if (!await FileSystemUtils.fileExists(nextPath)) {
+            const body = this.getBody('design');
+            const frontmatter = this.getFrontmatter('design');
+            const content = `${frontmatter.trim()}\n${ZHUANSPEC_MARKERS.start}\n${body}\n${ZHUANSPEC_MARKERS.end}\n`;
+            await FileSystemUtils.writeFile(nextPath, content);
+        }
+        await fs.unlink(legacyPath).catch(() => undefined);
+    }
+    async removeLegacyDesignCommand(projectPath) {
+        const legacyPath = FileSystemUtils.joinPath(projectPath, '.claude/commands/zhuanspec/design.md');
+        if (!await FileSystemUtils.fileExists(legacyPath)) {
+            return;
+        }
+        await fs.unlink(legacyPath).catch(() => undefined);
+    }
 }
 //# sourceMappingURL=claude.js.map