@waoooo/claude-skills 1.0.0

package/skills/job-create/SKILL.md

@@ -0,0 +1,294 @@
+# Skill: job-create
+
+## 功能
+
+创建新的 Job 目录结构和元信息文件。
+
+## 🚨 如何执行
+
+**使用现有脚本**（不要手动创建目录和文件）：
+
+```bash
+npx tsx src/scripts/create-job.ts \
+  --name <name> \
+  --goal <goal> \
+  --mdx-path <mdx-path>
+```
+
+**示例**：
+```bash
+npx tsx src/scripts/create-job.ts \
+  --name "pricing-frontend-refactor" \
+  --goal "重构前端代码，重命名 @workspace/membership → @workspace/pricing" \
+  --mdx-path "/Users/danlio/Repositories/waoooo/waoooo-docs/developer-docs/planning/pricing-system.mdx"
+```
+
+**注意**：
+- ✅ 使用 `--name`、`--goal`、`--mdx-path` 参数格式
+- ❌ 不要使用位置参数
+- ❌ 不要手动创建目录
+- ❌ 不要手动创建 metadata.json
+
+## 何时调用
+
+- 用户说："创建一个新 Job"
+- 用户说："开始新任务"
+- 用户说："新建项目"
+
+## 输入
+
+- `name` - Job 名称（例如：pricing-system）
+- `goal` - Job 目标（例如：实现多货币定价系统）
+- `mdxPath` - MDX 文档路径（例如：../../../waoooo-docs/developer-docs/planning/pricing-system.mdx）
+
+## 输出
+
+- Job 目录：`exports/jobs/YYYY-MM-DD-HHMM-<name>/`
+- `metadata.json` - Job 元信息
+
+## 执行步骤
+
+### 1. 生成 Job ID
+
+```
+格式: YYYY-MM-DD-HHMM-<name>
+示例: 2026-02-10-1520-pricing-system
+
+规则:
+- 使用当前时间戳
+- name 转为 kebab-case
+- 确保唯一性
+```
+
+### 2. 检查 Job 是否已存在
+
+**🚨 重要：创建前必须检查！**
+
+```bash
+# 检查目录是否存在
+if [ -d "exports/jobs/<job-id>" ]; then
+  echo "⚠️  Job 目录已存在: exports/jobs/<job-id>"
+  
+  # 询问用户
+  echo "选项："
+  echo "1. 继续使用现有 Job（跳过创建步骤）"
+  echo "2. 删除现有 Job 并重新创建"
+  echo "3. 使用不同的名称创建新 Job"
+  echo "4. 取消操作"
+fi
+```
+
+**处理逻辑**：
+- **选项 1（继续使用）**: 跳过 job-create，直接进入下一步
+- **选项 2（删除重建）**: 删除旧目录，继续创建流程
+- **选项 3（改名）**: 询问新名称，重新生成 Job ID
+- **选项 4（取消）**: 终止整个流程
+
+### 3. 创建目录结构
+
+```bash
+mkdir -p exports/jobs/<job-id>/source
+mkdir -p exports/jobs/<job-id>/parsed
+mkdir -p exports/jobs/<job-id>/analysis
+mkdir -p exports/jobs/<job-id>/specs
+mkdir -p exports/jobs/<job-id>/reviews
+mkdir -p exports/jobs/<job-id>/logs
+```
+
+### 4. 生成 metadata.json
+
+```json
+{
+  "$schema": "https://waoooo.com/schemas/job-metadata-v1.json",
+  "version": "1.0.0",
+  "id": "<job-id>",
+  "name": "<name>",
+  "description": "<goal>",
+  "createdAt": "<timestamp>",
+  "updatedAt": "<timestamp>",
+  "status": "pending",
+  
+  "source": {
+    "mdxPath": "<mdx-path>",
+    "hasForm": false
+  },
+  
+  "summary": {
+    "totalCapabilities": 0,
+    "available": 0,
+    "partial": 0,
+    "missing": 0,
+    "totalTasks": 0,
+    "estimatedHours": 0
+  }
+}
+```
+
+### 5. 验证
+
+- 检查目录是否创建成功
+- 检查 metadata.json 格式是否正确
+- 检查 MDX 文件是否存在
+
+## 使用示例
+
+### 示例 1：创建新 Job
+
+```
+用户: "创建一个新 Job，名称是 pricing-system"
+
+Agent 行动:
+1. 询问用户:
+   Q: "Job 目标是什么？"
+   A: "实现多货币定价系统"
+   
+   Q: "MDX 文档路径是什么？"
+   A: "../../../waoooo-docs/developer-docs/planning/pricing-system.mdx"
+
+2. 调用 job-create Skill
+   输入:
+   - name: pricing-system
+   - goal: 实现多货币定价系统
+   - mdxPath: ../../../waoooo-docs/developer-docs/planning/pricing-system.mdx
+
+3. 执行:
+   - 生成 Job ID: 2026-02-10-1520-pricing-system
+   - 创建目录结构
+   - 生成 metadata.json
+
+4. 显示结果:
+   ✅ Job 创建成功
+   📁 目录: exports/jobs/2026-02-10-1520-pricing-system/
+   📄 元信息: metadata.json
+```
+
+## 错误处理
+
+### 错误 1：MDX 文件不存在
+
+```
+❌ 错误: MDX 文件不存在
+📁 路径: planning/pricing-system.mdx
+
+💡 建议:
+1. 检查路径是否正确
+2. 确认文件在 waoooo-docs 仓库
+3. 使用绝对路径重试
+```
+
+### 错误 2：Job ID 冲突
+
+```
+❌ 错误: Job 目录已存在
+📁 目录: exports/jobs/2026-02-10-1520-pricing-system/
+
+💡 建议:
+1. 使用不同的名称
+2. 删除旧的 Job 目录
+3. 加载已有 Job 继续工作
+```
+
+### 错误 3：目录创建失败
+
+```
+❌ 错误: 无法创建目录
+🔍 原因: 权限不足
+
+💡 建议:
+1. 检查文件系统权限
+2. 检查磁盘空间
+3. 手动创建目录后重试
+```
+
+## 相关脚本
+
+需要创建：`src/scripts/create-job.ts`
+
+```typescript
+/**
+ * Create Job
+ * 
+ * Create new Job directory structure and metadata
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+interface JobInput {
+  name: string;
+  goal: string;
+  mdxPath: string;
+}
+
+function createJob(input: JobInput) {
+  // 1. Generate Job ID
+  const timestamp = new Date().toISOString().slice(0, 16).replace('T', '-').replace(/:/g, '');
+  const cleanName = input.name.toLowerCase().replace(/\s+/g, '-');
+  const jobId = `${timestamp}-${cleanName}`;
+  
+  // 2. Create directories
+  const jobDir = path.join('exports', 'jobs', jobId);
+  fs.mkdirSync(path.join(jobDir, 'source'), { recursive: true });
+  fs.mkdirSync(path.join(jobDir, 'parsed'), { recursive: true });
+  fs.mkdirSync(path.join(jobDir, 'analysis'), { recursive: true });
+  fs.mkdirSync(path.join(jobDir, 'specs'), { recursive: true });
+  
+  // 3. Generate metadata.json
+  const metadata = {
+    $schema: 'https://waoooo.com/schemas/job-metadata-v1.json',
+    version: '1.0.0',
+    id: jobId,
+    name: input.name,
+    description: input.goal,
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    status: 'pending',
+    source: {
+      mdxPath: input.mdxPath,
+      hasForm: false,
+    },
+    summary: {
+      totalCapabilities: 0,
+      available: 0,
+      partial: 0,
+      missing: 0,
+      totalTasks: 0,
+      estimatedHours: 0,
+    },
+  };
+  
+  fs.writeFileSync(
+    path.join(jobDir, 'metadata.json'),
+    JSON.stringify(metadata, null, 2)
+  );
+  
+  console.log(`✅ Job created: ${jobId}`);
+  return { jobId, jobDir };
+}
+
+// CLI
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const [name, goal, mdxPath] = process.argv.slice(2);
+  
+  if (!name || !goal || !mdxPath) {
+    console.error('Usage: tsx create-job.ts <name> <goal> <mdx-path>');
+    process.exit(1);
+  }
+  
+  try {
+    createJob({ name, goal, mdxPath });
+  } catch (error) {
+    console.error('❌ Error:', error);
+    process.exit(1);
+  }
+}
+
+export { createJob };
+```
+
+## 注意事项
+
+1. **Job ID 唯一性** - 使用时间戳确保唯一
+2. **目录结构固定** - 必须包含 source, parsed, analysis, specs
+3. **metadata.json 必需** - 后续所有步骤都依赖它
+4. **验证 MDX 路径** - 创建前检查文件是否存在

package/skills/job-create/scripts/create-job.ts

@@ -0,0 +1,105 @@
+/**
+ * Create Job
+ *
+ * Create new Job directory structure and metadata
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+interface JobInput {
+  name: string;
+  goal: string;
+  mdxPath?: string;
+}
+
+function createJob(input: JobInput) {
+  // 1. Generate Job ID
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  const hour = String(now.getHours()).padStart(2, '0');
+  const minute = String(now.getMinutes()).padStart(2, '0');
+  const timestamp = `${year}-${month}-${day}-${hour}${minute}`;
+
+  const cleanName = input.name.toLowerCase().replace(/\s+/g, '-');
+  const jobId = `${timestamp}-${cleanName}`;
+
+  // 2. Create directories
+  const jobDir = path.join('exports', 'jobs', jobId);
+  fs.mkdirSync(path.join(jobDir, 'source'), { recursive: true });
+  fs.mkdirSync(path.join(jobDir, 'parsed'), { recursive: true });
+  fs.mkdirSync(path.join(jobDir, 'analysis'), { recursive: true });
+  fs.mkdirSync(path.join(jobDir, 'specs'), { recursive: true });
+
+  // 3. Generate metadata.json
+  const metadata = {
+    $schema: 'https://waoooo.com/schemas/job-metadata-v1.json',
+    version: '1.0.0',
+    id: jobId,
+    name: input.name,
+    description: input.goal,
+    createdAt: now.toISOString(),
+    updatedAt: now.toISOString(),
+    status: 'pending',
+    source: {
+      mdxPath: input.mdxPath || null,
+      hasForm: false,
+    },
+    summary: {
+      totalCapabilities: 0,
+      available: 0,
+      partial: 0,
+      missing: 0,
+      totalTasks: 0,
+      estimatedHours: 0,
+    },
+  };
+
+  fs.writeFileSync(
+    path.join(jobDir, 'metadata.json'),
+    JSON.stringify(metadata, null, 2)
+  );
+
+  console.log(`✅ Job created: ${jobId}`);
+  console.log(`📁 Directory: ${jobDir}`);
+  return { jobId, jobDir };
+}
+
+// CLI
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+
+  // Parse arguments
+  let name = '';
+  let goal = '';
+  let mdxPath = '';
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--name' && args[i + 1]) {
+      name = args[i + 1];
+      i++;
+    } else if (args[i] === '--goal' && args[i + 1]) {
+      goal = args[i + 1];
+      i++;
+    } else if (args[i] === '--mdx-path' && args[i + 1]) {
+      mdxPath = args[i + 1];
+      i++;
+    }
+  }
+
+  if (!name || !goal) {
+    console.error('Usage: tsx create-job.ts --name <name> --goal <goal> [--mdx-path <path>]');
+    process.exit(1);
+  }
+
+  try {
+    createJob({ name, goal, mdxPath: mdxPath || undefined });
+  } catch (error) {
+    console.error('❌ Error:', error);
+    process.exit(1);
+  }
+}
+
+export { createJob };

package/skills/job-workflow/SKILL.md

@@ -0,0 +1,212 @@
+# Job Workflow Skill
+
+自动化 Job 创建和分析的完整工作流程。
+
+## 触发条件
+
+当用户说以下关键词时触发：
+- "创建 job"
+- "新建任务"
+- "开始新项目"
+- "分析需求"
+
+## 工作流程
+
+### 阶段 1: 准备工作
+
+1. **更新能力树**
+   ```bash
+   cd waoooo-web/tools/waoooo-product-builder
+   pnpm capability:build-tree
+   ```
+
+### 阶段 2: 创建 Job
+
+2. **询问用户信息**
+   - Job 名称（例如：pricing-system）
+   - Job 目标（例如：实现多货币定价系统）
+   - MDX 文档路径（例如：../../../waoooo-docs/developer-docs/planning/pricing-system.mdx）
+
+3. **生成 Job ID**
+   ```
+   格式: YYYY-MM-DD-HHMM-<name>
+   例如: 2026-02-10-1520-pricing-system
+   ```
+
+4. **创建 Job 目录结构**
+   ```bash
+   mkdir -p exports/jobs/<job-id>/source
+   mkdir -p exports/jobs/<job-id>/parsed
+   mkdir -p exports/jobs/<job-id>/analysis
+   mkdir -p exports/jobs/<job-id>/progress
+   ```
+
+5. **创建 metadata.json**
+   ```json
+   {
+     "id": "<job-id>",
+     "name": "<name>",
+     "goal": "<goal>",
+     "createdAt": "<timestamp>",
+     "status": "pending",
+     "mdxPath": "<mdx-path>"
+   }
+   ```
+
+### 阶段 3: 解析 MDX
+
+6. **检查 MDX 是否存在**
+   ```bash
+   # 如果不存在，提示用户先编写 MDX 文档
+   ```
+
+7. **解析 MDX 文档**
+   ```bash
+   pnpm spec:parse-docs \
+     <mdx-path> \
+     exports/jobs/<job-id>/parsed/docs.json
+   ```
+
+### 阶段 4: 推断/生成 form.json
+
+8. **检查是否有 form.json**
+   - 如果没有，自动推断生成
+
+9. **推断能力配置**
+   ```bash
+   pnpm spec:infer-builder \
+     exports/jobs/<job-id>/parsed/docs.json \
+     exports/jobs/<job-id>/parsed/form.json
+   ```
+
+### 阶段 5: 合并
+
+10. **合并 docs.json 和 form.json**
+    ```bash
+    pnpm spec:merge \
+      exports/jobs/<job-id>/parsed/docs.json \
+      exports/jobs/<job-id>/parsed/form.json \
+      exports/jobs/<job-id>/parsed/unified.json
+    ```
+
+### 阶段 6: 分析能力
+
+11. **分析能力依赖**
+    ```bash
+    pnpm spec:analyze-capabilities \
+      exports/jobs/<job-id>/parsed/unified.json \
+      exports/capability-tree/capability-tree.json \
+      exports/jobs/<job-id>/analysis/capability-analysis.json
+    ```
+
+12. **显示分析结果**
+    - 已有能力列表
+    - 缺失能力列表
+    - 依赖关系
+
+### 阶段 7: 生成任务
+
+13. **生成任务列表**
+    ```bash
+    pnpm spec:generate-tasks \
+      exports/jobs/<job-id>/analysis/capability-analysis.json \
+      exports/jobs/<job-id>/analysis/tasks.json
+    ```
+
+### 阶段 8: 生成全局视图
+
+14. **生成全局 ROADMAP**
+    ```bash
+    pnpm generate:roadmap
+    ```
+
+15. **显示执行计划**
+    - 读取 `exports/jobs/<job-id>/analysis/tasks.json`
+    - 显示任务列表和执行顺序
+
+### 阶段 9: 询问是否开始执行
+
+16. **询问用户**
+    ```
+    Job 分析完成！
+    
+    📊 能力分析:
+    - 已有: X 个
+    - 缺失: Y 个
+    
+    📋 执行计划:
+    1. 开发能力 A
+    2. 开发能力 B
+    3. 对接 Job 主功能
+    
+    是否开始执行？(y/n)
+    ```
+
+17. **如果用户确认，开始执行**
+    - 读取 tasks.json
+    - 按顺序执行每个任务
+    - 更新任务状态
+    - 更新能力树
+    - 回写 MDX
+
+## 命令快捷方式
+
+在 package.json 中添加：
+
+```json
+{
+  "scripts": {
+    "job:create": "tsx src/scripts/job-workflow.ts create",
+    "job:analyze": "tsx src/scripts/job-workflow.ts analyze",
+    "job:execute": "tsx src/scripts/job-workflow.ts execute"
+  }
+}
+```
+
+## 使用示例
+
+```bash
+# 方式 1: 使用 Skill（推荐）
+# 直接对 AI 说："创建一个新 job，名称是 pricing-system"
+
+# 方式 2: 使用命令行
+pnpm job:create pricing-system "实现多货币定价系统" ../../../waoooo-docs/developer-docs/planning/pricing-system.mdx
+```
+
+## 输出文件结构
+
+```
+exports/jobs/2026-02-10-1520-pricing-system/
+├── metadata.json              # Job 元信息
+├── source/
+│   └── planning.mdx          # 原始 MDX（链接）
+├── parsed/
+│   ├── docs.json             # 从 MDX 解析
+│   ├── form.json             # 推断的配置
+│   └── unified.json          # 合并结果
+├── analysis/
+│   ├── capability-analysis.json  # 能力分析
+│   └── tasks.json            # 任务列表
+└── progress/
+    └── execution.json        # 执行进度
+```
+
+## 注意事项
+
+1. **MDX 文档必须存在**：如果不存在，先提示用户编写
+2. **能力树必须最新**：执行前先运行 `pnpm capability:build-tree`
+3. **依赖关系自动分析**：系统会自动检测能力之间的依赖
+4. **执行顺序自动排序**：使用拓扑排序确定执行顺序
+
+## 错误处理
+
+- 如果 MDX 解析失败 → 检查 MDX 格式
+- 如果能力分析失败 → 检查 capability-tree.json
+- 如果依赖关系有环 → 手动调整依赖
+
+## 下一步
+
+完成 Job 分析后，可以：
+1. 查看全局视图：`pnpm generate:roadmap`
+2. 开始执行开发：按 tasks.json 顺序执行
+3. 更新进度：实时更新 execution.json