汉化主要的提示语和模板

Author: studyzy

.github/workflows/release.yml

@@ -0,0 +1,37 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build package
+        run: pnpm run build
+
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: pnpm run release:ci

Makefile

@@ -0,0 +1,37 @@
+# Makefile for OpenSpec-cn
+
+# You can override these via environment if needed
+PNPM ?= pnpm
+NODE ?= node
+
+.PHONY: all install deps build link unlink clean release
+
+# Default: install deps, build, and link as global "openspec-cn"
+all: install
+
+# Install dependencies, build, and link
+install: deps build link
+
+# Install JS dependencies using pnpm
+deps:
+	$(PNPM) install
+
+# Build the project (calls the build script)
+build:
+	$(PNPM) run build
+
+# Link this package globally so that the "openspec-cn" command is available
+link:
+	npm link
+
+# Remove the global link for this package
+unlink:
+	npm unlink --global @studyzy/openspec-cn || true
+
+# Simple clean placeholder (extend as needed)
+clean:
+	rm -rf node_modules dist
+
+# Release a new version to npm (publishes @studyzy/openspec-cn)
+release:
+	$(PNPM) run release:local

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@fission-ai/openspec",
+  "name": "@studyzy/openspec-cn",
   "version": "0.16.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
@@ -9,10 +9,10 @@
     "ai",
     "development"
   ],
-  "homepage": "https://github.com/Fission-AI/OpenSpec",
+  "homepage": "https://github.com/studyzy/OpenSpec-cn",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Fission-AI/OpenSpec"
+    "url": "https://github.com/studyzy/OpenSpec-cn"
   },
   "license": "MIT",
   "author": "OpenSpec Contributors",
@@ -27,7 +27,7 @@
     }
   },
   "bin": {
-    "openspec": "./bin/openspec.js"
+    "openspec-cn": "./bin/openspec.js"
   },
   "files": [
     "dist",

src/cli/index.ts

@@ -20,11 +20,11 @@ const { version } = require('../../package.json');
 
 program
   .name('openspec')
-  .description('AI-native system for spec-driven development')
+  .description('基于规范驱动开发的AI原生系统')
   .version(version);
 
 // Global options
-program.option('--no-color', 'Disable color output');
+program.option('--no-color', '禁用彩色输出');
 
 // Apply global flags before any command runs
 program.hook('preAction', (thisCommand) => {
@@ -35,11 +35,11 @@ program.hook('preAction', (thisCommand) => {
 });
 
 const availableToolIds = AI_TOOLS.filter((tool) => tool.available).map((tool) => tool.value);
-const toolsOptionDescription = `Configure AI tools non-interactively. Use "all", "none", or a comma-separated list of: ${availableToolIds.join(', ')}`;
+const toolsOptionDescription = `非交互式配置AI工具。使用 "all"、"none" 或逗号分隔的列表：${availableToolIds.join(', ')}`;
 
 program
   .command('init [path]')
-  .description('Initialize OpenSpec in your project')
+  .description('在您的项目中初始化OpenSpec')
   .option('--tools <tools>', toolsOptionDescription)
   .action(async (targetPath = '.', options?: { tools?: string }) => {
     try {
@@ -54,7 +54,7 @@ program
       } catch (error: any) {
         if (error.code === 'ENOENT') {
           // Directory doesn't exist, but we can create it
-          console.log(`Directory "${targetPath}" doesn't exist, it will be created.`);
+          console.log(`目录 "${targetPath}" 不存在，将被创建。`);
         } else if (error.message && error.message.includes('not a directory')) {
           throw error;
         } else {
@@ -68,70 +68,70 @@ program
       await initCommand.execute(targetPath);
     } catch (error) {
       console.log(); // Empty line for spacing
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });
 
 program
   .command('update [path]')
-  .description('Update OpenSpec instruction files')
+  .description('更新OpenSpec指令文件')
   .action(async (targetPath = '.') => {
     try {
       const resolvedPath = path.resolve(targetPath);
       const updateCommand = new UpdateCommand();
       await updateCommand.execute(resolvedPath);
     } catch (error) {
       console.log(); // Empty line for spacing
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });
 
 program
   .command('list')
-  .description('List items (changes by default). Use --specs to list specs.')
-  .option('--specs', 'List specs instead of changes')
-  .option('--changes', 'List changes explicitly (default)')
+  .description('列出项目（默认显示更改）。使用 --specs 列出规范。')
+  .option('--specs', '列出规范而非更改')
+  .option('--changes', '明确列出更改（默认）')
   .action(async (options?: { specs?: boolean; changes?: boolean }) => {
     try {
       const listCommand = new ListCommand();
       const mode: 'changes' | 'specs' = options?.specs ? 'specs' : 'changes';
       await listCommand.execute('.', mode);
     } catch (error) {
       console.log(); // Empty line for spacing
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });
 
 program
   .command('view')
-  .description('Display an interactive dashboard of specs and changes')
+  .description('显示规范和更改的交互式仪表板')
   .action(async () => {
     try {
       const viewCommand = new ViewCommand();
       await viewCommand.execute('.');
     } catch (error) {
       console.log(); // Empty line for spacing
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });
 
 // Change command with subcommands
 const changeCmd = program
   .command('change')
-  .description('Manage OpenSpec change proposals');
+  .description('管理OpenSpec变更提案');
 
 // Deprecation notice for noun-based commands
 changeCmd.hook('preAction', () => {
-  console.error('Warning: The "openspec change ..." commands are deprecated. Prefer verb-first commands (e.g., "openspec list", "openspec validate --changes").');
+  console.error('警告："openspec change ..." 命令已弃用。请优先使用动词开头的命令（例如 "openspec list", "openspec validate --changes"）。');
 });
 
 changeCmd
   .command('show [change-name]')
-  .description('Show a change proposal in JSON or markdown format')
+  .description('以JSON或markdown格式显示变更提案')
   .option('--json', 'Output as JSON')
   .option('--deltas-only', 'Show only deltas (JSON only)')
   .option('--requirements-only', 'Alias for --deltas-only (deprecated)')
@@ -141,30 +141,30 @@ changeCmd
       const changeCommand = new ChangeCommand();
       await changeCommand.show(changeName, options);
     } catch (error) {
-      console.error(`Error: ${(error as Error).message}`);
+      console.error(`错误：${(error as Error).message}`);
       process.exitCode = 1;
     }
   });
 
 changeCmd
   .command('list')
-  .description('List all active changes (DEPRECATED: use "openspec list" instead)')
+  .description('列出所有活动更改（已弃用：请使用 "openspec list"）')
   .option('--json', 'Output as JSON')
   .option('--long', 'Show id and title with counts')
   .action(async (options?: { json?: boolean; long?: boolean }) => {
     try {
-      console.error('Warning: "openspec change list" is deprecated. Use "openspec list".');
+      console.error('警告："openspec change list" 已弃用。请使用 "openspec list"。');
       const changeCommand = new ChangeCommand();
       await changeCommand.list(options);
     } catch (error) {
-      console.error(`Error: ${(error as Error).message}`);
+      console.error(`错误：${(error as Error).message}`);
       process.exitCode = 1;
     }
   });
 
 changeCmd
   .command('validate [change-name]')
-  .description('Validate a change proposal')
+  .description('验证变更提案')
   .option('--strict', 'Enable strict validation mode')
   .option('--json', 'Output validation report as JSON')
   .option('--no-interactive', 'Disable interactive prompts')
@@ -176,24 +176,24 @@ changeCmd
         process.exit(process.exitCode);
       }
     } catch (error) {
-      console.error(`Error: ${(error as Error).message}`);
+      console.error(`错误：${(error as Error).message}`);
       process.exitCode = 1;
     }
   });
 
 program
   .command('archive [change-name]')
-  .description('Archive a completed change and update main specs')
-  .option('-y, --yes', 'Skip confirmation prompts')
-  .option('--skip-specs', 'Skip spec update operations (useful for infrastructure, tooling, or doc-only changes)')
-  .option('--no-validate', 'Skip validation (not recommended, requires confirmation)')
+  .description('归档已完成的更改并更新主规范')
+  .option('-y, --yes', '跳过确认提示')
+  .option('--skip-specs', '跳过规范更新操作（适用于基础设施、工具或仅文档更改）')
+  .option('--no-validate', '跳过验证（不推荐，需要确认）')
   .action(async (changeName?: string, options?: { yes?: boolean; skipSpecs?: boolean; noValidate?: boolean; validate?: boolean }) => {
     try {
       const archiveCommand = new ArchiveCommand();
       await archiveCommand.execute(changeName, options);
     } catch (error) {
       console.log(); // Empty line for spacing
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });
@@ -203,11 +203,11 @@ registerSpecCommand(program);
 // Top-level validate command
 program
   .command('validate [item-name]')
-  .description('Validate changes and specs')
-  .option('--all', 'Validate all changes and specs')
-  .option('--changes', 'Validate all changes')
-  .option('--specs', 'Validate all specs')
-  .option('--type <type>', 'Specify item type when ambiguous: change|spec')
+  .description('验证更改和规范')
+  .option('--all', '验证所有更改和规范')
+  .option('--changes', '验证所有更改')
+  .option('--specs', '验证所有规范')
+  .option('--type <type>', '当项目类型不明确时指定类型：change|spec')
   .option('--strict', 'Enable strict validation mode')
   .option('--json', 'Output validation results as JSON')
   .option('--concurrency <n>', 'Max concurrent validations (defaults to env OPENSPEC_CONCURRENCY or 6)')
@@ -218,17 +218,17 @@ program
       await validateCommand.execute(itemName, options);
     } catch (error) {
       console.log();
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });
 
 // Top-level show command
 program
   .command('show [item-name]')
-  .description('Show a change or spec')
+  .description('显示更改或规范')
   .option('--json', 'Output as JSON')
-  .option('--type <type>', 'Specify item type when ambiguous: change|spec')
+  .option('--type <type>', '当项目类型不明确时指定类型：change|spec')
   .option('--no-interactive', 'Disable interactive prompts')
   // change-only flags
   .option('--deltas-only', 'Show only deltas (JSON only, change)')
@@ -245,7 +245,7 @@ program
       await showCommand.execute(itemName, options ?? {});
     } catch (error) {
       console.log();
-      ora().fail(`Error: ${(error as Error).message}`);
+      ora().fail(`错误：${(error as Error).message}`);
       process.exit(1);
     }
   });

src/commands/change.ts

@@ -282,10 +282,10 @@ export class ChangeCommand {
 
   private printNextSteps(): void {
     const bullets: string[] = [];
-    bullets.push('- Ensure change has deltas in specs/: use headers ## ADDED/MODIFIED/REMOVED/RENAMED Requirements');
-    bullets.push('- Each requirement MUST include at least one #### Scenario: block');
-    bullets.push('- Debug parsed deltas: openspec change show <id> --json --deltas-only');
-    console.error('Next steps:');
+    bullets.push('- 确保变更在specs/中有增量：使用标题## ADDED/MODIFIED/REMOVED/RENAMED Requirements');
+    bullets.push('- 每个需求必须至少包含一个#### 场景：块');
+    bullets.push('- 调试解析的增量：openspec-cn change show <id> --json --deltas-only');
+    console.error('后续步骤：');
     bullets.forEach(b => console.error(`  ${b}`));
   }
 }