nano-spec 1.1.2 → 1.1.3

package/README.md

@@ -12,8 +12,8 @@ npm install -g nano-spec
 # 2) 初始化（默认交互式选择 AI 工具）
 nanospec init
 
-# 3) 创建任务
-nanospec new "优化登录流程"
+# 3) 创建任务（可直接回车使用默认名“待命名”）
+nanospec new
 ```
 
 在 AI 工具中按顺序执行：
@@ -22,18 +22,23 @@ nanospec new "优化登录流程"
 - `/spec.2-plan`：生成实施方案与任务拆解
 - `/spec.3-execute`：执行任务并更新状态
 
+`/init` 使用建议（已初始化项目）：
+
+- 直接给出任务目标：`/init 创建用户认证功能`
+- 避免只输入 `/init` 或“创建任务”这类泛化描述，否则应先补充任务名与一句话目标
+
 ## 核心命令
 
-| 命令 | 说明 |
-|---|---|
-| `nanospec init` | 初始化项目结构与命令模板 |
-| `nanospec new [name]` | 创建任务目录并设为当前任务 |
-| `nanospec switch [name]` | 切换当前任务 |
-| `nanospec status` | 查看当前任务状态 |
-| `nanospec sync [--adapter <name>]` | 同步命令到 AI 工具目录 |
-| `nanospec preset list/install/uninstall` | 预设包管理 |
-| `nanospec config` | 查看当前配置 |
-| `nanospec config get/set/unset/list` | 读写配置（支持 `--global`） |
+| 命令 | 简写 | 说明 |
+|---|---|---|
+| `nanospec init` | `nanospec i` | 初始化项目结构与命令模板 |
+| `nanospec new [name]` | `nanospec n [name]` | 创建任务目录并设为当前任务；不带 `name` 时进入交互输入（默认“待命名”） |
+| `nanospec switch [name]` | `nanospec s [name]` | 切换当前任务 |
+| `nanospec status` | `nanospec st` | 查看当前任务状态 |
+| `nanospec sync [--adapter <name>]` | `nanospec sy [--adapter <name>]` | 同步命令到 AI 工具目录 |
+| `nanospec preset list/install/uninstall` | `nanospec p ls/add/rm` | 预设包管理 |
+| `nanospec config` | `nanospec c` | 查看当前配置 |
+| `nanospec config get/set/unset/list` | `nanospec c g/s/u/ls` | 读写配置（支持 `--global`） |
 
 ## 工作流概览
 

package/bin/nanospec.js

@@ -1,2 +1,4 @@
 #!/usr/bin/env node
-import '../dist/index.js';
+import {createProgram} from '../dist/index.js';
+
+createProgram().parse();

package/dist/commands/new.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
+import inquirer from 'inquirer';
 import { loadConfig } from '../config/config.js';
 import { setCurrentTask } from '../config/task-pointer.js';
 export async function newTask(name) {
@@ -11,7 +12,18 @@ export async function newTask(name) {
         return;
     }
     const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
-    const taskName = name || '待命名';
+    let taskName = name?.trim();
+    if (!taskName) {
+        const result = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'taskName',
+                message: '任务名称：',
+                default: '待命名',
+            },
+        ]);
+        taskName = result.taskName?.trim() || '待命名';
+    }
     const dirName = `${date}-${taskName}`;
     const taskDir = join(nanospecDir, dirName);
     if (existsSync(taskDir)) {

package/dist/commands/new.test.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, rmSync } from 'fs';
 import { join } from 'path';
+import inquirer from 'inquirer';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { newTask } from './new.js';
 describe('new command', () => {
@@ -32,10 +33,12 @@ describe('new command', () => {
     it('应该创建带日期戳的任务目录', async () => {
         // 先初始化项目
         mkdirSync(nanospecDir, { recursive: true });
+        const promptSpy = vi.spyOn(inquirer, 'prompt');
         await newTask('用户认证功能');
         const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
         const taskDir = join(nanospecDir, `${date}-用户认证功能`);
         expect(existsSync(taskDir)).toBe(true);
+        expect(promptSpy).not.toHaveBeenCalled();
     });
     it('应该创建任务目录结构（brief.md、assets/、outputs/）', async () => {
         mkdirSync(nanospecDir, { recursive: true });
@@ -57,10 +60,25 @@ describe('new command', () => {
     });
     it('应该使用"待命名"作为默认名称', async () => {
         mkdirSync(nanospecDir, { recursive: true });
+        const promptSpy = vi
+            .spyOn(inquirer, 'prompt')
+            .mockResolvedValue({ taskName: '' });
         await newTask();
         const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
         const taskDir = join(nanospecDir, `${date}-待命名`);
         expect(existsSync(taskDir)).toBe(true);
+        expect(promptSpy).toHaveBeenCalledOnce();
+    });
+    it('应该在无参时进入交互模式并使用用户输入名称', async () => {
+        mkdirSync(nanospecDir, { recursive: true });
+        const promptSpy = vi
+            .spyOn(inquirer, 'prompt')
+            .mockResolvedValue({ taskName: '登录体验优化' });
+        await newTask();
+        const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        const taskDir = join(nanospecDir, `${date}-登录体验优化`);
+        expect(existsSync(taskDir)).toBe(true);
+        expect(promptSpy).toHaveBeenCalledOnce();
     });
     it('应该在目录已存在时显示警告', async () => {
         mkdirSync(nanospecDir, { recursive: true });

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 #!/usr/bin/env node
-export {};
+import { Command } from 'commander';
+export declare function createProgram(): Command;

package/dist/index.js

@@ -7,72 +7,88 @@ import { showStatus } from './commands/status.js';
 import { listPresets, installPreset, uninstallPreset } from './commands/preset.js';
 import { syncCommands } from './commands/sync.js';
 import { config } from './commands/config.js';
-const program = new Command();
-program
-    .name('nanospec')
-    .description('nanospec - Spec 驱动开发工作流')
-    .version('1.0.0');
-program
-    .command('init')
-    .description('初始化 nanospec 项目结构')
-    .option('--ai <tool>', 'AI 工具类型（非交互式快速初始化）')
-    .option('-f, --force', '强制覆盖已存在的文件')
-    .action((options) => init(options));
-program
-    .command('new [name]')
-    .description('创建新的任务目录')
-    .action((name) => newTask(name));
-program
-    .command('switch [name]')
-    .description('切换当前任务')
-    .action((name) => switchTask(name));
-program
-    .command('status')
-    .description('显示当前状态')
-    .action(() => showStatus());
-const presetCmd = program
-    .command('preset')
-    .description('预设包管理');
-presetCmd
-    .command('list')
-    .description('列出所有可用预设')
-    .action(() => listPresets());
-presetCmd
-    .command('install [name]')
-    .description('安装预设（不指定名称时使用交互式选择）')
-    .action((name) => installPreset(name));
-presetCmd
-    .command('uninstall <name>')
-    .description('卸载预设')
-    .action((name) => uninstallPreset(name));
-program
-    .command('sync')
-    .description('同步命令到 AI 工具')
-    .option('--adapter <name>', '指定 AI 工具')
-    .action((options) => syncCommands(options));
-const configCmd = program
-    .command('config')
-    .description('配置管理');
-configCmd
-    .command('get <key>')
-    .description('获取配置值')
-    .option('-g, --global', '操作全局配置')
-    .action((key, options) => config('get', key, undefined, options));
-configCmd
-    .command('set <key> <value>')
-    .description('设置配置')
-    .option('-g, --global', '操作全局配置')
-    .action((key, value, options) => config('set', key, value, options));
-configCmd
-    .command('unset <key>')
-    .description('删除配置项')
-    .option('-g, --global', '操作全局配置')
-    .action((key, options) => config('unset', key, undefined, options));
-configCmd
-    .command('list')
-    .description('列出所有配置项')
-    .option('-g, --global', '操作全局配置')
-    .action((options) => config(undefined, undefined, undefined, { ...options, list: true }));
-configCmd
-    .action((options) => config(undefined, undefined, undefined, options));
-program.parse();
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('nanospec')
+        .description('nanospec - Spec 驱动开发工作流')
+        .version('1.0.0');
+    program
+        .command('init')
+        .alias('i')
+        .description('初始化 nanospec 项目结构')
+        .option('--ai <tool>', 'AI 工具类型（非交互式快速初始化）')
+        .option('-f, --force', '强制覆盖已存在的文件')
+        .action((options) => init(options));
+    program
+        .command('new [name]')
+        .alias('n')
+        .description('创建新的任务目录')
+        .action((name) => newTask(name));
+    program
+        .command('switch [name]')
+        .alias('s')
+        .description('切换当前任务')
+        .action((name) => switchTask(name));
+    program
+        .command('status')
+        .alias('st')
+        .description('显示当前状态')
+        .action(() => showStatus());
+    const presetCmd = program
+        .command('preset')
+        .alias('p')
+        .description('预设包管理');
+    presetCmd
+        .command('list')
+        .alias('ls')
+        .description('列出所有可用预设')
+        .action(() => listPresets());
+    presetCmd
+        .command('install [name]')
+        .alias('add')
+        .description('安装预设（不指定名称时使用交互式选择）')
+        .action((name) => installPreset(name));
+    presetCmd
+        .command('uninstall <name>')
+        .alias('rm')
+        .description('卸载预设')
+        .action((name) => uninstallPreset(name));
+    program
+        .command('sync')
+        .alias('sy')
+        .description('同步命令到 AI 工具')
+        .option('--adapter <name>', '指定 AI 工具')
+        .action((options) => syncCommands(options));
+    const configCmd = program
+        .command('config')
+        .alias('c')
+        .description('配置管理');
+    configCmd
+        .command('get <key>')
+        .alias('g')
+        .description('获取配置值')
+        .option('-g, --global', '操作全局配置')
+        .action((key, options) => config('get', key, undefined, options));
+    configCmd
+        .command('set <key> <value>')
+        .alias('s')
+        .description('设置配置')
+        .option('-g, --global', '操作全局配置')
+        .action((key, value, options) => config('set', key, value, options));
+    configCmd
+        .command('unset <key>')
+        .alias('u')
+        .description('删除配置项')
+        .option('-g, --global', '操作全局配置')
+        .action((key, options) => config('unset', key, undefined, options));
+    configCmd
+        .command('list')
+        .alias('ls')
+        .description('列出所有配置项')
+        .option('-g, --global', '操作全局配置')
+        .action((options) => config(undefined, undefined, undefined, { ...options, list: true }));
+    configCmd
+        .action((options) => config(undefined, undefined, undefined, options));
+    return program;
+}

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest';
+import { createProgram } from './index.js';
+describe('cli command registration', () => {
+    it('should register aliases for top-level commands', () => {
+        const program = createProgram();
+        const expectedAliases = [
+            ['init', 'i'],
+            ['new', 'n'],
+            ['switch', 's'],
+            ['status', 'st'],
+            ['preset', 'p'],
+            ['sync', 'sy'],
+            ['config', 'c'],
+        ];
+        for (const [name, alias] of expectedAliases) {
+            const command = program.commands.find((cmd) => cmd.name() === name);
+            expect(command, `missing command: ${name}`).toBeDefined();
+            expect(command?.aliases()).toContain(alias);
+        }
+    });
+    it('should register alias for switch command as s', () => {
+        const program = createProgram();
+        const switchCommand = program.commands.find((cmd) => cmd.name() === 'switch');
+        expect(switchCommand).toBeDefined();
+        expect(switchCommand?.aliases()).toContain('s');
+    });
+});

package/dist/static/commands/command-templates.test.js

@@ -14,8 +14,18 @@ describe('command templates', () => {
     it('should use nanospec commands in init and run templates', () => {
         const initTemplate = readFileSync(join(__dirname, 'spec.init.toml'), 'utf-8');
         const runTemplate = readFileSync(join(__dirname, 'spec.run.toml'), 'utf-8');
-        expect(initTemplate).toContain('nanospec init');
         expect(initTemplate).toContain('nanospec new');
         expect(runTemplate).toContain('nanospec new');
     });
+    it('should keep init template focused on task creation without environment detection', () => {
+        const initTemplate = readFileSync(join(__dirname, 'spec.init.toml'), 'utf-8');
+        expect(initTemplate).not.toContain('Step 1: 检测环境');
+        expect(initTemplate).not.toContain('nanospec init --ai cursor');
+        expect(initTemplate).toContain('执行创建任务流程');
+    });
+    it('should require clarification when task name cannot be extracted in init template', () => {
+        const initTemplate = readFileSync(join(__dirname, 'spec.init.toml'), 'utf-8');
+        expect(initTemplate).toContain('如果无法明确提取任务名');
+        expect(initTemplate).toContain('不执行 `nanospec new`');
+    });
 });

package/dist/static/commands/command-templates.test.ts

@@ -19,8 +19,22 @@ describe('command templates', () => {
 		const initTemplate = readFileSync(join(__dirname, 'spec.init.toml'), 'utf-8');
 		const runTemplate = readFileSync(join(__dirname, 'spec.run.toml'), 'utf-8');
 
-		expect(initTemplate).toContain('nanospec init');
 		expect(initTemplate).toContain('nanospec new');
 		expect(runTemplate).toContain('nanospec new');
 	});
+
+	it('should keep init template focused on task creation without environment detection', () => {
+		const initTemplate = readFileSync(join(__dirname, 'spec.init.toml'), 'utf-8');
+
+		expect(initTemplate).not.toContain('Step 1: 检测环境');
+		expect(initTemplate).not.toContain('nanospec init --ai cursor');
+		expect(initTemplate).toContain('执行创建任务流程');
+	});
+
+	it('should require clarification when task name cannot be extracted in init template', () => {
+		const initTemplate = readFileSync(join(__dirname, 'spec.init.toml'), 'utf-8');
+
+		expect(initTemplate).toContain('如果无法明确提取任务名');
+		expect(initTemplate).toContain('不执行 `nanospec new`');
+	});
 });

package/dist/static/commands/spec.init.toml

@@ -1,44 +1,29 @@
 # Command: spec.init
-# Description: 初始化或创建任务 - 检测环境并初始化，或创建新任务
+# Description: 创建任务 - 从用户意图创建任务并填写 brief
 # Category: nanospec
 # Version: 1
 
-description = "初始化或创建任务 - 检测环境并初始化，或创建新任务"
+description = "创建任务 - 从用户意图创建任务并填写 brief"
 
 prompt = """
-# /init - 初始化或创建任务
+# /init - 创建任务
 
 > 遵循 `<config_dir>/AGENTS.md` 通用规范
 
 ## Role
 
-你是"环境初始化助手"：检测当前环境状态，执行初始化或创建任务。
+你是"任务创建助手"：从用户输入中提取任务名称和意图，创建任务并填写 brief。
 
 ## Objective
 
-根据当前环境状态执行不同操作：
-1. **未初始化**：执行 `nanospec init` 初始化目录结构
-2. **已初始化**：执行 `nanospec new` 创建任务，并根据用户意图填写 brief.md
-
-## Decision Protocol
-
-### Step 1: 检测环境
-
-检查 `<config_dir>/AGENTS.md` 是否存在：
-- **不存在** → 执行初始化流程
-- **存在** → 执行创建任务流程
-
-### Step 2A: 初始化流程（未初始化时）
-
-1. 执行 shell 命令：`nanospec init --ai cursor`
-2. 确认生成了 `<config_dir>/AGENTS.md`
-3. 提示用户初始化完成，可以开始创建任务
-
-### Step 2B: 创建任务流程（已初始化时）
-
+执行创建任务流程：
 1. 从用户输入中提取任务名称和意图
-2. 执行 shell 命令：`nanospec new "<任务名称>"`
-3. 根据用户意图，填写 `<specs_dir>/<task_name>/brief.md`：
+2. 对任务名称做有效性检查：
+   - 任务名应当和要做的事情直接相关（功能、页面、模块、问题）
+   - 禁止使用泛化命名：`初始化或创建任务`、`新任务`、`临时任务`、`todo` 等
+   - 如果无法明确提取任务名，先向用户提问后再继续，不得直接执行 `nanospec new`
+3. 执行 shell 命令：`nanospec new "<任务名称>"`
+4. 根据用户意图，填写 `<specs_dir>/<task_name>/brief.md`：
    - 背景：用户的原始描述
    - 目标：从意图中提炼的目标
    - 约束：如有提及则填写，否则留空待补充
@@ -46,17 +31,14 @@ prompt = """
 ## Input
 
 用户的自然语言描述，例如：
-- "初始化 nano-spec"
 - "创建一个用户认证功能"
 - "我要做一个支持暗黑模式的设置页面"
+- "/init 创建用户认证功能（支持邮箱+验证码登录）"
+- "/init 修复订单页在移动端按钮遮挡问题"
 
 ## Output
 
-### 初始化场景
-
-执行命令并报告结果。
-
-### 创建任务场景
+### 创建任务
 
 1. 执行 `nanospec new` 命令
 2. 填写 brief.md，格式：
@@ -75,10 +57,16 @@ prompt = """
 
 3. 提示用户下一步使用 `/{{cmd_prefix}}.1-spec` 生成规格说明
 
+### 信息不足场景
+
+1. 不执行 `nanospec new`
+2. 先向用户提一个简短问题：请提供任务名称和一句话目标
+3. 得到补充后再继续创建任务
+
 ## Checklist
 
-- 正确判断了环境状态
-- 执行了相应的 nanospec 命令
-- （创建任务时）brief.md 已填写用户意图
+- 已提取并校验任务名
+- 执行了 `nanospec new`
+- brief.md 已填写用户意图
 
 """

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nano-spec",
-	"version": "1.1.2",
+	"version": "1.1.3",
 	"description": "A minimal extendable Spec-Driven framework. Not just for code -- for writing, research, and anything you want to get done.",
 	"type": "module",
 	"main": "dist/index.js",