create-vibe-workflow 0.1.0 → 0.2.0

package/dist/templates/hooks/check-deps.mjs

@@ -1,65 +1,66 @@
-#!/usr/bin/env node
-
-// 依赖检测 — Claude Code PreToolUse hook
-// 检查外部依赖组件是否已安装，缺失时打印中文安装指引
-
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-
-const homeDir = homedir();
-const skillsDir = join(homeDir, '.claude', 'skills');
-
-const REQUIRED = [
-  { name: 'gstack', dir: 'gstack', install: 'cd ~/.claude/skills && git clone https://github.com/garrytan/gstack.git gstack' },
-  { name: 'superpowers', dir: 'superpowers', install: 'https://github.com/anthropics/claude-code-superpowers' },
-];
-
-const OPTIONAL = [
-  { name: 'openspec', dir: 'openspec', install: 'npm install -g @anthropic/openspec' },
-];
-
-const missing = [];
-const missingOptional = [];
-
-for (const dep of REQUIRED) {
-  if (!existsSync(join(skillsDir, dep.dir))) {
-    missing.push(dep);
-  }
-}
-
-for (const dep of OPTIONAL) {
-  if (!existsSync(join(skillsDir, dep.dir))) {
-    missingOptional.push(dep);
-  }
-}
-
-if (missing.length === 0 && missingOptional.length === 0) {
-  process.exit(0);
-}
-
-console.log('');
-console.log('══════════════════════════════════════════');
-console.log('  ⚠️  工作流依赖检查');
-console.log('══════════════════════════════════════════');
-
-if (missing.length > 0) {
-  console.log('');
-  console.log('❌ 缺少必要组件（工作流核心功能将不可用）：');
-  for (const dep of missing) {
-    console.log(`  • ${dep.name} — 安装: ${dep.install}`);
-  }
-}
-
-if (missingOptional.length > 0) {
-  console.log('');
-  console.log('⚠️  缺少可选组件（部分高级功能不可用）：');
-  for (const dep of missingOptional) {
-    console.log(`  • ${dep.name} — 安装: ${dep.install}`);
-  }
-}
-
-console.log('');
-console.log('安装后可重启 Claude Code 以启用完整工作流。');
-console.log('══════════════════════════════════════════');
-console.log('');
+#!/usr/bin/env node
+
+// 依赖检测 — Claude Code PreToolUse hook
+// 检查外部依赖组件是否已安装，缺失时打印中文安装指引
+
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const homeDir = homedir();
+const skillsDir = join(homeDir, '.claude', 'skills');
+
+const REQUIRED = [
+  { name: 'gstack', dir: 'gstack', install: 'https://github.com/garrytan/gstack' },
+  { name: 'superpowers', dir: 'superpowers', install: 'https://github.com/obra/superpowers' },
+];
+
+const OPTIONAL = [
+  { name: 'openspec', dir: 'openspec', install: 'https://github.com/Fission-AI/OpenSpec' },
+  { name: 'everything-claude-code', dir: 'everything-claude-code', install: 'https://github.com/affaan-m/everything-claude-code' },
+];
+
+const missing = [];
+const missingOptional = [];
+
+for (const dep of REQUIRED) {
+  if (!existsSync(join(skillsDir, dep.dir))) {
+    missing.push(dep);
+  }
+}
+
+for (const dep of OPTIONAL) {
+  if (!existsSync(join(skillsDir, dep.dir))) {
+    missingOptional.push(dep);
+  }
+}
+
+if (missing.length === 0 && missingOptional.length === 0) {
+  process.exit(0);
+}
+
+console.log('');
+console.log('══════════════════════════════════════════');
+console.log('  ⚠️  工作流依赖检查');
+console.log('══════════════════════════════════════════');
+
+if (missing.length > 0) {
+  console.log('');
+  console.log('❌ 缺少必要组件（工作流核心功能将不可用）：');
+  for (const dep of missing) {
+    console.log(`  • ${dep.name} — 安装: ${dep.install}`);
+  }
+}
+
+if (missingOptional.length > 0) {
+  console.log('');
+  console.log('⚠️  缺少可选组件（部分高级功能不可用）：');
+  for (const dep of missingOptional) {
+    console.log(`  • ${dep.name} — 安装: ${dep.install}`);
+  }
+}
+
+console.log('');
+console.log('安装后可重启 Claude Code 以启用完整工作流。');
+console.log('══════════════════════════════════════════');
+console.log('');

package/dist/templates/memory/MEMORY.md.ejs

@@ -0,0 +1,88 @@
+<!--
+  ============================================================
+  项目记忆索引文件
+  ============================================================
+  这是索引文件，不是记忆本身。每行指向一条记忆文件。
+  AI 会在每次对话开始时读取此文件，快速了解项目状态。
+  新增记忆后，记得在这里加一行索引。
+
+  格式：
+  - [Title](file.md) — 一句话钩子（让 AI 快速判断是否需要读这篇）
+
+  更新规则：
+  - 新增记忆后立即更新此文件
+  - 记忆已过期？保留索引但标注 (archived)
+  - 不要删除索引，保留历史轨迹
+  ============================================================
+-->
+
+# 记忆索引
+
+> 最后更新：<%= GENERATED_AT.split('T')[0] %>
+> 总记忆数：N 条（其中活跃 M 条，已归档 K 条）
+
+---
+
+## 👤 用户 & 团队
+
+<!-- 格式示例（使用时取消注释并替换）：
+### 当前成员
+- [team-member.md](team-member.md) — 团队角色和分工
+
+### 用户偏好
+- [preferences.md](preferences.md) — 编码风格偏好、命名习惯、常用工具
+-->
+
+_暂无记录_
+
+---
+
+## 💬 反馈 & 经验
+
+<!-- 格式示例（使用时取消注释并替换）：
+### 用户反馈
+- [feedback-2025-06-01.md](feedback-2025-06-01.md) — 用户对列表页性能不满意，希望优化加载速度
+
+### 经验教训
+- [lessons-auth.md](lessons-auth.md) — 认证模块踩坑记录：refresh token 轮换策略选型
+-->
+
+_暂无记录_
+
+---
+
+## 📋 项目状态
+
+<!-- 格式示例（使用时取消注释并替换）：
+### 里程碑
+- [milestone-v1.md](milestone-v1.md) — v1.0 发布: 2025-05-15，核心功能完成
+
+### 活跃模块
+- [module-auth.md](module-auth.md) — 认证模块：JWT + OAuth2，已稳定运行
+- [module-order.md](module-order.md) — 订单模块：开发中，预计下周完成
+
+### TODOs
+- [todo-refactor.md](todo-refactor.md) — 计划重构支付模块，拆分过大的 PaymentService
+
+### 技术债务
+- [tech-debt.md](tech-debt.md) — 当前已知的技术债务清单
+-->
+
+_暂无记录_
+
+---
+
+## 📚 参考 & 外部
+
+<!-- 格式示例（使用时取消注释并替换）：
+### 技术参考
+- [architecture-decisions.md](architecture-decisions.md) — 关键架构决策记录（ADR）
+
+### 外部资源
+- [external-apis.md](external-apis.md) — 集成的外部服务 API 文档和凭据指引
+
+### 术语表
+- [glossary.md](glossary.md) — 项目专用术语和缩写解释
+-->
+
+_暂无记录_

package/dist/templates/memory/dev-notes.md.ejs

@@ -0,0 +1,61 @@
+<!--
+  ============================================================
+  开发笔记
+  ============================================================
+  目的：记录项目开发过程中发现的模式、踩坑记录、好用做法。
+  这些是经验性的东西，不是正式文档，但非常有用。
+
+  说明：
+  - 每条记录以日期开头：YYYY-MM-DD 内容描述
+  - 按时间倒序排列（最新的在最上面）
+  - 保持简洁，每条 1-5 行
+  - 如果某条经验后来被证伪，不要删除，追加说明 (deprecated)
+  ============================================================
+-->
+
+# 开发笔记
+
+> 项目：<%= PROJECT_NAME %>
+> 最后更新：<%= GENERATED_AT.split('T')[0] %>
+
+---
+
+## 模式发现
+
+<!-- 记录项目中发现的重复模式和约定 -->
+
+<!-- 示例：
+### 2025-06-01 Service 层统一返回 Result 对象
+所有 Service 方法都返回 { success, data, error } 结构，Controller 层不再 try-catch。
+这样可以统一错误处理，前端也方便判断。
+-->
+
+_暂无记录_
+
+---
+
+## 踩坑记录
+
+<!-- 记录解决过的坑，避免重复踩 -->
+
+<!-- 示例：
+### 2025-06-01 Drizzle 迁移文件命名冲突
+同时运行两个迁移时，由于文件名按时间戳排序，可能导致外键引用顺序错误。
+解决：手动指定迁移顺序，在文件名前加序号前缀如 001_、002_。
+-->
+
+_暂无记录_
+
+---
+
+## 好用做法
+
+<!-- 记录团队发现的高效做法 -->
+
+<!-- 示例：
+### 2025-06-01 使用 Zod 推断类型代替手写接口
+先在 schema.ts 定义 Zod schema，再用 z.infer 推断类型。
+这样 schema 和类型永远一致，不需要手动同步。
+-->
+
+_暂无记录_

package/dist/templates/memory/troubleshooting.md.ejs

@@ -0,0 +1,30 @@
+<!--
+  ============================================================
+  排错日志
+  ============================================================
+  目的：记录开发中遇到的错误、根因和解决方案。
+  每次遇到报错并解决后，在这里追加一条记录。
+
+  说明：
+  - 每条记录一行表格式，使用 | 分隔
+  - 按日期倒序排列（最新的在最上面）
+  - 根因要写到具体的技术原因，不要只写"配置错了"
+  - 如果同一个问题反复出现，说明根因没找对
+  ============================================================
+-->
+
+# 排错日志
+
+> 项目：<%= PROJECT_NAME %>
+> 最后更新：<%= GENERATED_AT.split('T')[0] %>
+
+| 日期 | 现象 | 根因 | 解决 |
+|------|------|------|------|
+<!--
+| 2025-06-01 | `Cannot find module` 构建报错 | tsconfig.json 中 paths 配置与 ts-node 的路径解析不一致 | 在 tsconfig.json 中配置 `tsconfig-paths` 插件，并安装 `tsconfig-paths` 依赖 |
+| 2025-06-02 | 列表页首次加载白屏 3 秒 | 服务端渲染时未使用流式渲染，所有数据加载完才返回 | 改用 `React.lazy` + `Suspense` 实现流式加载 |
+
+注意：日期列使用 YYYY-MM-DD 格式，按日期倒序排列。
+-->
+
+_暂无记录_

package/dist/templates/rules/agents.md

@@ -1,49 +1,49 @@
-# Agent Orchestration
-
-## Available Agents
-
-Located in `~/.claude/agents/`:
-
-| Agent | Purpose | When to Use |
-|-------|---------|-------------|
-| planner | Implementation planning | Complex features, refactoring |
-| architect | System design | Architectural decisions |
-| tdd-guide | Test-driven development | New features, bug fixes |
-| code-reviewer | Code review | After writing code |
-| security-reviewer | Security analysis | Before commits |
-| build-error-resolver | Fix build errors | When build fails |
-| e2e-runner | E2E testing | Critical user flows |
-| refactor-cleaner | Dead code cleanup | Code maintenance |
-| doc-updater | Documentation | Updating docs |
-
-## Immediate Agent Usage
-
-No user prompt needed:
-1. Complex feature requests - Use **planner** agent
-2. Code just written/modified - Use **code-reviewer** agent
-3. Bug fix or new feature - Use **tdd-guide** agent
-4. Architectural decision - Use **architect** agent
-
-## Parallel Task Execution
-
-ALWAYS use parallel Task execution for independent operations:
-
-```markdown
-# GOOD: Parallel execution
-Launch 3 agents in parallel:
-1. Agent 1: Security analysis of auth module
-2. Agent 2: Performance review of cache system
-3. Agent 3: Type checking of utilities
-
-# BAD: Sequential when unnecessary
-First agent 1, then agent 2, then agent 3
-```
-
-## Multi-Perspective Analysis
-
-For complex problems, use split role sub-agents:
-- Factual reviewer
-- Senior engineer
-- Security expert
-- Consistency reviewer
-- Redundancy checker
+# Agent 编排（Agent Orchestration）
+
+## 可用 Agent
+
+位于 `~/.claude/agents/`：
+
+| Agent | 用途 | 使用场景 |
+|-------|------|----------|
+| planner | 实现计划制定 | 复杂功能、重构方案 |
+| architect | 系统设计 | 架构决策、技术选型 |
+| tdd-guide | 测试驱动开发指导 | 新功能、Bug 修复 |
+| code-reviewer | 代码审查 | 写完代码后执行 |
+| security-reviewer | 安全分析 | 提交前检查 |
+| build-error-resolver | 构建错误修复 | 编译/构建失败时 |
+| e2e-runner | E2E 测试 | 关键用户流程验证 |
+| refactor-cleaner | 死代码清理 | 代码维护、优化 |
+| doc-updater | 文档更新 | 同步文档变更 |
+
+## 即时使用规则
+
+无需用户额外提示，以下场景自动触发：
+1. **复杂功能请求** → 使用 **planner** agent
+2. **代码刚写完/修改后** → 使用 **code-reviewer** agent
+3. **Bug 修复或新功能** → 使用 **tdd-guide** agent
+4. **架构决策** → 使用 **architect** agent
+
+## 并行任务执行
+
+**始终**对独立操作使用并行 Task 执行：
+
+```markdown
+# ✅ 推荐：并行执行
+同时启动 3 个 agent：
+1. Agent 1: 安全审查（auth 模块）
+2. Agent 2: 性能审查（缓存系统）
+3. Agent 3: 类型检查（工具函数）
+
+# ❌ 不推荐：不必要的串行
+先等 agent 1，再 agent 2，再 agent 3
+```
+
+## 多视角分析
+
+对于复杂问题，使用分角色子 agent：
+- 事实核查者（Factual reviewer）
+- 高级工程师（Senior engineer）
+- 安全专家（Security expert）
+- 一致性检查员（Consistency reviewer）
+- 冗余检测器（Redundancy checker）