feat(init): 优化初始化流程，集成 OpenSpec 并自动下载技能

- 移除本地 contract 模板目录及相关构建逻辑
- 自动检测并安装 OpenSpec 依赖
- 静默执行 openspec init 避免重复提示
- 为支持的 IDE 下载 tml-docs-spec-generate 技能
- 自动创建标准化的 docs 目录结构
- 更新工具适配器接口以支持初始化后操作

Author: Geniusay

TMLSPEC-cli/package-lock.json

@@ -8,16 +8,13 @@
   },
   "files": [
     "bin",
-    "contract",
     "dist",
     "src/core/commands",
     "README.md"
   ],
   "scripts": {
-    "prebuild": "node ./scripts/sync-contract.mjs",
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/cli/index.ts",
-    "prepack": "node ./scripts/sync-contract.mjs",
     "start": "node ./bin/tml-spec.js"
   },
   "keywords": [
@@ -35,9 +32,11 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^7.8.4",
-    "commander": "^13.1.0"
+    "commander": "^13.1.0",
+    "degit": "^2.8.4"
   },
   "devDependencies": {
+    "@types/degit": "^2.8.6",
     "@types/node": "^24.0.0",
     "tsx": "^4.20.3",
     "typescript": "^5.9.2"

TMLSPEC-cli/package.json

@@ -1,6 +1,8 @@
+import path from 'node:path';
 import { buildProjectMarkdownCommand, buildRequirementMarkdownCommand } from '../command-files.js';
 import { buildNamespacedCommandPath, COMMAND_NAMESPACE } from '../command-paths.js';
 import type { ToolAdapter } from '../types.js';
+import { downloadSkill } from '../../utils/fs.js';
 
 export const traeAdapter: ToolAdapter = {
   tool: {
@@ -20,5 +22,15 @@ export const traeAdapter: ToolAdapter = {
         content: buildRequirementMarkdownCommand()
       }
     ];
+  },
+  async postInit(projectRoot: string) {
+    const destPath = path.join(projectRoot, '.trae/skills/tml-docs-spec-generate');
+    console.log('Downloading tml-docs-spec-generate skill for Trae...');
+    try {
+      await downloadSkill('Time-Machine-Lab/TML-Skills/skills/tml-docs-spec-generate', destPath);
+      console.log('Skill downloaded successfully to .trae/skills/tml-docs-spec-generate');
+    } catch (error) {
+      console.error('Failed to download skill for Trae:', error);
+    }
   }
 };

TMLSPEC-cli/src/core/adapters/trae.ts

@@ -4,11 +4,11 @@ import { checkbox, confirm, input } from '@inquirer/prompts';
 import { getAdapter } from './adapters/index.js';
 import { TOOL_OPTIONS } from './catalog.js';
 import type { InitAnswers, ToolId } from './types.js';
-import { copyDirectory, writeTextFile } from '../utils/fs.js';
+import { scaffoldDirectories, writeTextFile } from '../utils/fs.js';
+import { checkCommandExists, runCommand } from '../utils/exec.js';
 
 const currentDir = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(currentDir, '../..');
-const bundledContractDirectory = path.join(packageRoot, 'contract');
 
 interface InitOverrides {
   projectRoot?: string;
@@ -78,6 +78,19 @@ async function collectAnswers(overrides: InitOverrides): Promise<InitAnswers> {
 
 export async function runInit(overrides: InitOverrides = {}): Promise<void> {
   const answers = await collectAnswers(overrides);
+
+  console.log('检查 OpenSpec 依赖...');
+  const hasOpenSpec = await checkCommandExists('openspec');
+  if (!hasOpenSpec) {
+    console.log('未检测到 OpenSpec，正在全局安装 @fission-ai/openspec@latest...');
+    try {
+      await runCommand('npm install -g @fission-ai/openspec@latest');
+      console.log('OpenSpec 安装完成。');
+    } catch (error) {
+      console.error('OpenSpec 安装失败，请稍后手动安装。');
+    }
+  }
+
   let writtenFiles = 0;
   let skippedFiles = 0;
 
@@ -94,23 +107,37 @@ export async function runInit(overrides: InitOverrides = {}): Promise<void> {
         skippedFiles += 1;
       }
     }
+
+    if (adapter.postInit) {
+      await adapter.postInit(answers.projectRoot);
+    }
+  }
+
+  try {
+    console.log('执行 OpenSpec 初始化...');
+    await runCommand(`openspec init --tools ${answers.tools.join(',')} "${answers.projectRoot}" --force`);
+    console.log('OpenSpec 初始化完成。');
+  } catch (error) {
+    console.error('OpenSpec 初始化时发生错误。');
   }
 
-  const contractTargetPath = path.join(answers.projectRoot, 'contract');
-  const contractCopied = await copyDirectory(bundledContractDirectory, contractTargetPath, answers.force);
+  await scaffoldDirectories(answers.projectRoot, [
+    'docs/api',
+    'docs/sql',
+    'docs/project',
+    'docs/project/domain'
+  ]);
 
   const relativeRoot = path.relative(process.cwd(), answers.projectRoot) || '.';
   console.log('TML Spec 命令已初始化。');
   console.log(`项目根目录: ${relativeRoot}`);
   console.log(`已选择工具: ${answers.tools.join(', ')}`);
   console.log(`写入文件数: ${writtenFiles}`);
   console.log(`跳过文件数: ${skippedFiles}`);
-  console.log(`contract 模板目录: ${contractCopied ? '已写入项目根目录' : '已存在，未覆盖'}`);
   console.log('下一步:');
   console.log('1. 在你的 IDE 中打开生成的命令或 prompt 文件。');
-  console.log('2. 在项目根目录下查看 contract 模板目录，并按需补充团队规范。');
-  console.log('3. 使用 tml-spec 命名空间下的 project 命令处理项目级文档工作。');
-  console.log('4. 使用 tml-spec 命名空间下的 requirement 命令处理需求级工作，并路由到 openspec。');
+  console.log('2. 使用 tml-spec 命名空间下的 project 命令处理项目级文档工作。');
+  console.log('3. 使用 tml-spec 命名空间下的 requirement 命令处理需求级工作，并路由到 openspec。');
 }
 
 export function parseInitOverrides(options: {

TMLSPEC-cli/src/core/init.ts

@@ -21,4 +21,5 @@ export interface GeneratedCommandFile {
 export interface ToolAdapter {
   tool: ToolOption;
   generateFiles(): GeneratedCommandFile[];
+  postInit?(projectRoot: string): Promise<void>;
 }

TMLSPEC-cli/src/core/types.ts

@@ -0,0 +1,19 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const execAsync = promisify(exec);
+
+export async function checkCommandExists(command: string): Promise<boolean> {
+  try {
+    await execAsync(`${command} --version`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function runCommand(command: string, options = {}): Promise<void> {
+  const { stdout, stderr } = await execAsync(command, options);
+  if (stdout) console.log(stdout.trim());
+  if (stderr) console.error(stderr.trim());
+}

TMLSPEC-cli/src/utils/exec.ts

@@ -1,5 +1,6 @@
 import { access, cp, mkdir, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import degit from 'degit';
 
 export async function ensureDirectory(dirPath: string): Promise<void> {
   await mkdir(dirPath, { recursive: true });
@@ -24,20 +25,22 @@ export async function writeTextFile(filePath: string, content: string, overwrite
   return true;
 }
 
-export async function copyDirectory(sourcePath: string, targetPath: string, overwrite = true): Promise<boolean> {
-  if (!await pathExists(sourcePath)) {
-    throw new Error(`Source directory does not exist: ${sourcePath}`);
-  }
-
-  if (!overwrite && await pathExists(targetPath)) {
-    return false;
-  }
-
-  if (overwrite && await pathExists(targetPath)) {
-    await rm(targetPath, { recursive: true, force: true });
+export async function scaffoldDirectories(projectRoot: string, directories: string[]): Promise<void> {
+  for (const dir of directories) {
+    const fullPath = path.join(projectRoot, dir);
+    await ensureDirectory(fullPath);
+    const gitkeepPath = path.join(fullPath, '.gitkeep');
+    if (!await pathExists(gitkeepPath)) {
+      await writeFile(gitkeepPath, '', 'utf8');
+    }
   }
+}
 
-  await ensureDirectory(path.dirname(targetPath));
-  await cp(sourcePath, targetPath, { recursive: true, force: overwrite });
-  return true;
+export async function downloadSkill(repositoryPath: string, destPath: string): Promise<void> {
+  const emitter = degit(repositoryPath, {
+    cache: false,
+    force: true,
+    verbose: true
+  });
+  await emitter.clone(destPath);
 }