6a-spec-install 1.0.1-dev.2 → 1.0.1-dev.20

package/.claude/commands/6A/6A-execute-task.md

@@ -0,0 +1,20 @@
+---
+description: 6A-code: 执行开发任务 (Execute Task)
+---
+
+# 执行开发任务指令
+
+该指令用于触发标准化的代码实现流程。
+
+## 触发动作
+当用户提供一个任务文件路径（如 `@task_01_api_xxx.md`）并要求“执行任务”时：
+
+1.  **激活角色**：切换至 `Senior Developer` 角色。
+2.  **调用 SOP**：严格遵循 `.6aspec/rules/6A/6A_code_implementation_sop.md` 中的协议。
+    - **Step 0**: 上下文加载 (Task + TDD + Rules)
+    - **Step 1**: 自底向上编码 (DTO -> Repo -> Service -> API)
+    - **Step 2**: 质量检查 (Lint)
+    - **Step 3**: 状态更新 (Task File + README)
+
+## 快捷指令参数
+用户可以直接输入：`6A-exec @task_file`

package/.claude/commands/6A/6A-import-model-table.md

@@ -0,0 +1,8 @@
+---
+description: 6A-import-model-table workflow
+---
+1. Immediate response upon activation: 6A-import-model-table workflow has been activated
+2. Read file: `.6aspec/rules/6A/6A_import_model_table_sop.md`
+3. Strictly follow the "Import Model Table SOP" defined in that file
+4. Execute the python script to import entities
+

package/.claude/commands/6A/6A-init.md

@@ -0,0 +1,14 @@
+---
+description: Init Project Artifacts (Functional Map & Event List)
+---
+Immediate response upon activation: Project Artifacts Initialization workflow has been activated.
+
+Phase 1: Functional Capability Map
+1. Read file: `.6aspec/rules/6A/6A_init_map_sop.md`
+2. Strictly follow the "Init Functional Capability Map SOP" defined in that file.
+3. Execute the codebase scan and update the artifact at `.6aspec/biz/functional-capability-Map.md`.
+
+Phase 2: Event List
+1. Read file: `.6aspec/rules/6A/6A_init_event_list_sop.md`
+2. Strictly follow the "Event List Generation SOP" defined in that file.
+3. Execute the codebase scan and update the artifact at `.6aspec/biz/event-list.md`.

package/.claude/commands/6A/6A-model.md

@@ -0,0 +1,11 @@
+---
+description: 6A-model workflow
+---
+1. Immediate response upon activation: 6A-model workflow has been activated
+2. **Context Restriction**: 
+   - Do NOT perform `codebase_search`.
+   - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
+   - Stop and ask the user if you think you need more information.
+3. Read file: `.6aspec/rules/6A/6A_model_sop.md`
+4. Strictly follow the "Domain modeling and database design Architecture SOP" defined in that file
+5. Output the Domain model and table design

package/.claude/commands/6A/6A-new.md

@@ -0,0 +1,7 @@
+---
+description: 6A-new workflow
+---
+1. Immediate response upon activation: 6A-new workflow has been activated.
+2. Read file: `.6aspec/rules/6A/6A_new_feature_sop.md`
+3. Strictly follow the "New Feature Architecture SOP" defined in that file.
+4. Output the Technical Design Document (TDD).

package/.claude/commands/6A/6A-task.md

@@ -0,0 +1,7 @@
+---
+description: 6A-task workflow
+---
+1. Immediate response upon activation: 6A-task workflow has been activated
+2. Read file: `.6aspec/rules/6A/6A_task_sop.md`
+3. Strictly follow the "Task Decomposition SOP" defined in that file
+4. Output the task list

package/.claude/commands/6A/6A-visual-logic.md

@@ -0,0 +1,9 @@
+---
+description: 6A-visual-logic workflow
+---
+1. Immediate response upon activation: 6A-visual-logic workflow has been activated.
+2. Read file: `.6aspec/rules/6A/6A_visual_logic_sop.md`.
+3. Strictly follow the "Visual Logic Diagrams SOP" defined in that file.
+4. Output Mermaid diagrams as specified in the SOP.
+
+

package/.cursor/commands/6A-execute-task.md

@@ -0,0 +1,21 @@
+---
+description: 6A-code: 执行开发任务 (Execute Task)
+alwaysApply: false
+---
+
+# 执行开发任务指令
+
+该指令用于触发标准化的代码实现流程。
+
+## 触发动作
+当用户提供一个任务文件路径（如 `@task_01_api_xxx.md`）并要求“执行任务”时：
+
+1.  **激活角色**：切换至 `Senior Developer` 角色。
+2.  **调用 SOP**：严格遵循 `.6aspec/rules/6A/6A_code_implementation_sop.md` 中的协议。
+    - **Step 0**: 上下文加载 (Task + TDD + Rules)
+    - **Step 1**: 自底向上编码 (DTO -> Repo -> Service -> API)
+    - **Step 2**: 质量检查 (Lint)
+    - **Step 3**: 状态更新 (Task File + README)
+
+## 快捷指令参数
+用户可以直接输入：`6A-exec @task_file`

package/.cursor/commands/6A-import-model-table.md

@@ -0,0 +1,9 @@
+---
+description: 6A-import-model-table workflow
+alwaysApply: false
+---
+1. Immediate response upon activation: 6A-import-model-table workflow has been activated
+2. Read file: `.6aspec/rules/6A/6A_import_model_table_sop.md`
+3. Strictly follow the "Import Model Table SOP" defined in that file
+4. Execute the python script to import entities
+

package/.cursor/commands/6A-init.md

@@ -0,0 +1,15 @@
+---
+description: Init Project Artifacts (Functional Map & Event List)
+alwaysApply: false
+---
+Immediate response upon activation: Project Artifacts Initialization workflow has been activated.
+
+Phase 1: Functional Capability Map
+1. Read file: `.6aspec/rules/6A/6A_init_map_sop.md`
+2. Strictly follow the "Init Functional Capability Map SOP" defined in that file.
+3. Execute the codebase scan and update the artifact at `.6aspec/biz/functional-capability-Map.md`.
+
+Phase 2: Event List
+1. Read file: `.6aspec/rules/6A/6A_init_event_list_sop.md`
+2. Strictly follow the "Event List Generation SOP" defined in that file.
+3. Execute the codebase scan and update the artifact at `.6aspec/biz/event-list.md`.

package/.cursor/commands/6A-model.md

@@ -3,6 +3,10 @@ description: 6A-model workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: 6A-model workflow has been activated
-2. Read file: `.cursor/rules/6A/6A_model_sop.md`
-3. Strictly follow the "Domain modeling and database design Architecture SOP" defined in that file
-4. Output the Domain model and table design
+2. **Context Restriction**: 
+   - Do NOT perform `codebase_search`.
+   - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
+   - Stop and ask the user if you think you need more information.
+3. Read file: `.6aspec/rules/6A/6A_model_sop.md`
+4. Strictly follow the "Domain modeling and database design Architecture SOP" defined in that file
+5. Output the Domain model and table design

package/.cursor/commands/6A-new.md

@@ -3,6 +3,6 @@ description: 6A-new workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: 6A-new workflow has been activated.
-2. Read file: `.cursor/rules/6A/6A_new_feature_sop.md`
+2. Read file: `.6aspec/rules/6A/6A_new_feature_sop.md`
 3. Strictly follow the "New Feature Architecture SOP" defined in that file.
 4. Output the Technical Design Document (TDD).

package/.cursor/commands/6A-task.md

@@ -3,6 +3,6 @@ description: 6A-task workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: 6A-task workflow has been activated
-2. Read file: `.cursor/rules/6A/6A_task_sop.md`
+2. Read file: `.6aspec/rules/6A/6A_task_sop.md`
 3. Strictly follow the "Task Decomposition SOP" defined in that file
 4. Output the task list

package/.cursor/commands/6A-visual-logic.md

@@ -3,7 +3,7 @@ description: 6A-visual-logic workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: 6A-visual-logic workflow has been activated.
-2. Read file: `.cursor/rules/6A/6A_visual_logic_sop.md`.
+2. Read file: `.6aspec/rules/6A/6A_visual_logic_sop.md`.
 3. Strictly follow the "Visual Logic Diagrams SOP" defined in that file.
 4. Output Mermaid diagrams as specified in the SOP.
 

package/lib/installer.js

@@ -12,21 +12,23 @@ class Installer {
   // 查找包目录（支持本地开发和 npm 安装）
   findPackageDir() {
     // 如果是本地开发，直接使用当前目录
-    if (fs.existsSync(path.join(__dirname, '../.cursor'))) {
+    if (fs.existsSync(path.join(__dirname, '../.6aspec')) || 
+        fs.existsSync(path.join(__dirname, '../.cursor'))) {
       return path.join(__dirname, '..');
     }
     
     // 如果是 npm 安装，查找 node_modules
     let current = __dirname;
     while (current !== path.dirname(current)) {
+      const sixaspecPath = path.join(current, '.6aspec');
       const cursorPath = path.join(current, '.cursor');
-      if (fs.existsSync(cursorPath)) {
+      if (fs.existsSync(sixaspecPath) || fs.existsSync(cursorPath)) {
         return current;
       }
       current = path.dirname(current);
     }
     
-    throw new Error('未找到 .cursor 目录，请确保包已正确安装');
+    throw new Error('未找到 .6aspec 或 .cursor 目录，请确保包已正确安装');
   }
 
   // 颜色输出
@@ -51,11 +53,31 @@ class Installer {
     return null;
   }
 
+  // 递归删除目录
+  removeDir(dirPath) {
+    if (fs.existsSync(dirPath)) {
+      const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+          this.removeDir(fullPath);
+        } else {
+          fs.unlinkSync(fullPath);
+        }
+      }
+      fs.rmdirSync(dirPath);
+    }
+  }
+
   // 递归复制目录（完全覆盖模式）
   copyDir(src, dest) {
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
+    // 如果目标目录存在，先完全删除（确保完全覆盖）
+    if (fs.existsSync(dest)) {
+      this.removeDir(dest);
     }
+    
+    // 重新创建目录并复制
+    fs.mkdirSync(dest, { recursive: true });
 
     const entries = fs.readdirSync(src, { withFileTypes: true });
 
@@ -125,15 +147,16 @@ class Installer {
     return files;
   }
 
-  // 安装 Cursor 配置
-  installCursor() {
-    this.log('开始安装 Cursor 配置...');
+  // 安装公共配置 (.6aspec)
+  install6aspec() {
+    this.log('开始安装公共配置 (.6aspec)...');
     
-    const sourceDir = path.join(this.packageDir, '.cursor');
-    const targetDir = path.join(this.targetDir, '.cursor');
+    const sourceDir = path.join(this.packageDir, '.6aspec');
+    const targetDir = path.join(this.targetDir, '.6aspec');
 
     if (!fs.existsSync(sourceDir)) {
-      throw new Error('未找到 .cursor 源目录');
+      this.log('未找到 .6aspec 源目录，跳过', 'warn');
+      return;
     }
 
     const targetExists = fs.existsSync(targetDir);
@@ -162,10 +185,57 @@ class Installer {
       if (targetExists) {
         this.backupDir(targetDir);
       }
-      this.log('复制 Cursor 配置文件...');
+      this.log('复制公共配置文件...');
       this.copyDir(sourceDir, targetDir);
     }
     
+    this.log('✓ 公共配置安装完成！', 'success');
+  }
+
+  // 安装 Cursor 配置
+  installCursor() {
+    this.log('开始安装 Cursor 配置...');
+    
+    const sourceDir = path.join(this.packageDir, '.cursor');
+    const targetDir = path.join(this.targetDir, '.cursor');
+
+    if (!fs.existsSync(sourceDir)) {
+      throw new Error('未找到 .cursor 源目录');
+    }
+
+    const targetExists = fs.existsSync(targetDir);
+    
+    if (this.mergeMode && targetExists) {
+      // 智能合并模式
+      this.log('使用智能合并模式（保留用户自定义文件）...');
+      
+      // 只复制 commands 目录
+      const commandsSourceDir = path.join(sourceDir, 'commands');
+      if (fs.existsSync(commandsSourceDir)) {
+        const commandsTargetDir = path.join(targetDir, 'commands');
+        const result = this.mergeDir(commandsSourceDir, commandsTargetDir);
+        this.log(`commands: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
+      }
+    } else {
+      // 完全覆盖模式
+      if (targetExists) {
+        this.backupDir(targetDir);
+      }
+      this.log('复制 Cursor 配置文件...');
+      
+      // 创建目标目录
+      if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+      }
+      
+      // 只复制 commands 目录
+      const commandsSourceDir = path.join(sourceDir, 'commands');
+      if (fs.existsSync(commandsSourceDir)) {
+        const commandsTargetDir = path.join(targetDir, 'commands');
+        this.copyDir(commandsSourceDir, commandsTargetDir);
+      }
+    }
+    
     this.log('✓ Cursor 配置安装完成！', 'success');
   }
 
@@ -173,11 +243,12 @@ class Installer {
   installClaude() {
     this.log('开始安装 Claude 配置...');
     
-    const sourceDir = path.join(this.packageDir, '.cursor');
+    const sourceDir = path.join(this.packageDir, '.claude');
     const targetDir = path.join(this.targetDir, '.claude');
 
     if (!fs.existsSync(sourceDir)) {
-      throw new Error('未找到源配置目录');
+      this.log('未找到 .claude 源目录，跳过', 'warn');
+      return;
     }
 
     const targetExists = fs.existsSync(targetDir);
@@ -191,33 +262,13 @@ class Installer {
       // 智能合并模式
       this.log('使用智能合并模式（保留用户自定义文件）...');
       
-      // 复制 commands 到 prompts
+      // 复制 commands
       const commandsDir = path.join(sourceDir, 'commands');
       if (fs.existsSync(commandsDir)) {
-        const promptsDir = path.join(targetDir, 'prompts');
-        const result = this.mergeDir(commandsDir, promptsDir);
-        if (result.updated > 0 || result.added > 0) {
-          this.log(`prompts: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
-        }
-      }
-
-      // 复制 rules
-      const rulesDir = path.join(sourceDir, 'rules');
-      if (fs.existsSync(rulesDir)) {
-        const targetRulesDir = path.join(targetDir, 'rules');
-        const result = this.mergeDir(rulesDir, targetRulesDir);
+        const targetCommandsDir = path.join(targetDir, 'commands');
+        const result = this.mergeDir(commandsDir, targetCommandsDir);
         if (result.updated > 0 || result.added > 0) {
-          this.log(`rules: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
-        }
-      }
-
-      // 复制 scripts
-      const scriptDir = path.join(sourceDir, 'script');
-      if (fs.existsSync(scriptDir)) {
-        const targetScriptDir = path.join(targetDir, 'script');
-        const result = this.mergeDir(scriptDir, targetScriptDir);
-        if (result.updated > 0 || result.added > 0) {
-          this.log(`script: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
+          this.log(`commands: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
         }
       }
     } else {
@@ -225,27 +276,13 @@ class Installer {
       if (targetExists) {
         this.backupDir(targetDir);
       }
-      this.log('转换并复制 Claude 配置文件...');
+      this.log('复制 Claude 配置文件...');
       
-      // 复制 commands 到 prompts
+      // 复制 commands
       const commandsDir = path.join(sourceDir, 'commands');
       if (fs.existsSync(commandsDir)) {
-        const promptsDir = path.join(targetDir, 'prompts');
-        this.copyDir(commandsDir, promptsDir);
-      }
-
-      // 复制 rules
-      const rulesDir = path.join(sourceDir, 'rules');
-      if (fs.existsSync(rulesDir)) {
-        const targetRulesDir = path.join(targetDir, 'rules');
-        this.copyDir(rulesDir, targetRulesDir);
-      }
-
-      // 复制 scripts
-      const scriptDir = path.join(sourceDir, 'script');
-      if (fs.existsSync(scriptDir)) {
-        const targetScriptDir = path.join(targetDir, 'script');
-        this.copyDir(scriptDir, targetScriptDir);
+        const targetCommandsDir = path.join(targetDir, 'commands');
+        this.copyDir(commandsDir, targetCommandsDir);
       }
     }
     
@@ -266,6 +303,9 @@ class Installer {
     }
 
     try {
+      // 无论安装哪个工具，都要先安装公共配置
+      this.install6aspec();
+      
       switch (tool.toLowerCase()) {
         case 'cursor':
           this.installCursor();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "6a-spec-install",
-  "version": "1.0.1-dev.2",
+  "version": "1.0.1-dev.20",
   "description": "6A-spec 驱动开发提示词安装工具，支持 Cursor 和 Claude",
   "main": "lib/installer.js",
   "bin": {
@@ -48,6 +48,8 @@
     "bin/",
     "lib/",
     ".cursor/",
+    ".claude/",
+    ".6aspec/",
     "README.md"
   ],
   "engines": {

package/.cursor/commands/6A-excel-table-gen.md

@@ -1,9 +0,0 @@
----
-description: 6A-export-table workflow
-alwaysApply: false
----
-1. Immediate response upon activation: 6A-export-table workflow has been activated.
-2. Read file: `.cursor/rules/6A/6A_export_table_to_excel_sop.md`.
-3. Strictly and exclusively follow the "Excel file generation SOP" defined in that file.
-4. Do not invent, infer, or supplement any rules beyond the SOP.
-5. Output Excel files exactly as specified in the SOP.

package/.cursor/commands/execute-task.md

@@ -1,9 +0,0 @@
----
-description: task-execute workflow
-alwaysApply: false
----
-1. 激活后立即响应：任务执行工作流已被激活
-2. 必需输入：任务文档(如@.docs/入住办理/task/TASK-03-单个办理入住核心逻辑.md)
-3. 要求
-   - 注意不要编写单元测试
-   - 完成后更新任务的状态

package/.cursor/rules/6A/6A_export_table_to_excel_sop.md

@@ -1,133 +0,0 @@
----
-description: 从Markdown文档提取表结构并生成Excel文件的标准操作流程 (Export table schema from Markdown to Excel SOP)
-alwaysApply: false
----
-
-# 6A-export-table: 从Markdown文档提取表结构并生成Excel文件的标准操作流程
-
-## 角色
-你现在的角色是【文档处理专家 + 自动化工具执行者】，负责从Markdown文档中提取表结构设计信息，并自动生成标准化的Excel文件。
-
-## 目标
-从包含表结构设计的Markdown文档中提取所有表定义，为每个表生成一个格式化的Excel文件，便于后续的数据建模、开发参考和文档归档。
-
-## 规则
-1. **严格遵循脚本规范**：必须使用提供的Python脚本 `.cursor/script/md_to_excel.py`，不得自行编写或修改脚本逻辑
-2. **输入验证**：执行前必须验证Markdown文件存在且可读
-3. **输出验证**：执行后必须验证Excel文件是否成功生成
-4. **错误处理**：如遇到错误，必须提供清晰的错误信息和解决建议
-5. **路径处理**：所有文件路径必须使用绝对路径或相对于工作区根目录的路径
-
-## 输入要求
-- **必需输入**：
-  - Markdown文档路径（包含表结构设计的文档）
-  - 输出目录路径（可选，默认为当前目录）
-- **Markdown文档格式要求**：
-  - 表定义必须以 `##### 数字. 表名 (表英文名)` 格式开头
-  - 必须包含表信息表格（表中文名称 | 表英文名称）
-  - 必须包含字段信息表格（字段中文名称 | 字段英文名称 | 字段类型 | 是否必填 | 字段说明）
-
-## 标准操作流程 (SOP)
-
-### 第一步：确认输入参数
-1. **验证Markdown文件路径**
-   - 检查文件是否存在
-   - 确认文件路径格式正确（支持相对路径和绝对路径）
-   - 如果用户未提供完整路径，尝试在工作区中查找
-
-2. **确认输出目录**
-   - 如果用户指定了输出目录，验证目录是否存在
-   - 如果目录不存在，提示是否创建
-   - 如果未指定，使用当前目录或Markdown文件所在目录
-
-### 第二步：执行Python脚本
-1. **构建命令**
-   ```bash
-   python .cursor/script/md_to_excel.py <markdown_file_path> [output_dir]
-   ```
-   
-2. **执行要求**
-   - 使用绝对路径执行脚本
-   - 确保Python环境可用（Python 3.x）
-   - 确保所需依赖已安装（openpyxl）
-
-3. **执行脚本**
-   - 调用终端命令执行Python脚本
-   - 捕获并显示执行输出
-   - 检查返回码
-
-### 第三步：验证输出结果
-1. **检查执行状态**
-   - 验证脚本是否成功执行（返回码为0）
-   - 检查是否有错误输出
-
-2. **验证生成的文件**
-   - 确认Excel文件已生成
-   - 验证文件数量是否与提取的表数量一致
-   - 检查文件是否可读
-
-3. **输出结果摘要**
-   - 列出所有生成的Excel文件路径
-   - 显示每个文件对应的表名
-
-### 第四步：错误处理
-如果执行失败，按以下步骤处理：
-
-1. **分析错误类型**
-   - 文件不存在错误：提示检查文件路径
-   - 格式错误：提示检查Markdown格式是否符合要求
-   - 依赖缺失：提示安装openpyxl库
-   - Python环境错误：提示检查Python版本
-
-2. **提供解决建议**
-   - 针对具体错误提供修复建议
-   - 如果Markdown格式不符合要求，指出具体问题
-
-## 输出要求
-1. **执行过程输出**
-   - 显示读取的Markdown文件路径
-   - 显示提取到的表结构数量
-   - 显示每个Excel文件的生成状态
-
-2. **最终结果输出**
-   - 列出所有成功生成的Excel文件路径
-   - 提供文件位置摘要
-
-3. **格式要求**
-   - 使用清晰的中文提示信息
-   - 使用emoji图标增强可读性（✅、❌、📖、📊等）
-
-## 示例用法
-
-### 示例1：基本用法
-```
-用户输入：从 .docs/服务评价/MODEL_服务评价.md 生成Excel文件
-执行：python .cursor/script/md_to_excel.py .docs/服务评价/MODEL_服务评价.md
-输出：在 .docs/服务评价/ 目录下生成对应的Excel文件
-```
-
-### 示例2：指定输出目录
-```
-用户输入：从 MODEL_服务评价.md 生成Excel到 ./excel_output 目录
-执行：python .cursor/script/md_to_excel.py MODEL_服务评价.md ./excel_output
-输出：在 ./excel_output 目录下生成对应的Excel文件
-```
-
-## 注意事项
-1. **Python依赖**：确保已安装 `openpyxl` 库，可通过 `pip install openpyxl` 安装
-2. **文件编码**：Markdown文件必须使用UTF-8编码
-3. **表格式要求**：Markdown中的表必须严格按照脚本期望的格式编写
-4. **文件命名**：生成的Excel文件以表英文名命名（如：`rental_ServiceEvaluation.xlsx`）
-5. **覆盖行为**：如果输出目录中已存在同名Excel文件，脚本会覆盖该文件
-
-## 脚本功能说明
-Python脚本 `.cursor/script/md_to_excel.py` 的主要功能：
-- **提取表结构**：从Markdown中识别以 `##### 数字. 表名` 开头的表定义
-- **解析表信息**：提取表中文名、表英文名、表说明
-- **解析字段信息**：提取每个字段的中文名、英文名、类型、是否必填、说明
-- **生成Excel**：为每个表生成格式化的Excel文件，包含：
-  - 表基本信息（表中文名、表英文名、说明）
-  - 字段详情表格（字段中文名、字段英文名、字段类型、是否必填、字段说明）
-  - 格式化样式（表头背景色、边框、对齐方式等）
-
-