create-dwy 0.5.1 → 0.6.0

package/bin/index.js

@@ -22,7 +22,7 @@ program
 
 program
   .command('sync <target>')
-  .description('Sync configuration (claude | project-claude)')
+  .description('Sync Claude configuration (claude | project-claude)')
   .action(async (target) => {
     if (target === 'claude') {
       await syncClaude()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Project scaffolding and Claude Code config sync CLI",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
   ],
   "keywords": ["cli", "scaffold", "fastapi", "vue"],
   "license": "MIT",
-  "author": "danweiyuan",
+  "author": "dwydev",
   "dependencies": {
     "commander": "^12.0.0",
     "inquirer": "^9.0.0",

package/src/create.js

@@ -6,7 +6,8 @@ import { renderTemplate, chalk, PACKAGE_ROOT } from './utils.js'
 export async function createProject(name) {
   console.log(chalk.blue('Creating a new project...\n'))
 
-  const answers = await inquirer.prompt([
+  // Step 1: common questions
+  const common = await inquirer.prompt([
     {
       type: 'input',
       name: 'projectName',
@@ -25,43 +26,58 @@ export async function createProject(name) {
       name: 'template',
       message: '选择项目模板:',
       choices: [
-        { name: 'web     — Vue + FastAPI', value: 'web' },
-        { name: 'mobile  — 移动端 + FastAPI (预留)', value: 'mobile', disabled: '即将推出' },
-        { name: 'backend — 纯 FastAPI 服务 (预留)', value: 'backend', disabled: '即将推出' },
+        { name: 'web      — Vue 3 前端 (pnpm monorepo, eui + ekit + Tailwind)', value: 'web' },
+        { name: 'backend  — FastAPI 后端 (eapi + PostgreSQL + Redis + Docker)', value: 'backend' },
+        { name: 'mobile   — 移动端 (暂未实现)', value: 'mobile', disabled: '即将推出' },
       ],
     },
-    {
-      type: 'confirm',
-      name: 'includeDolphindb',
-      message: '需要 DolphinDB 吗?',
-      default: false,
-    },
-    {
-      type: 'input',
-      name: 'sshAlias',
-      message: 'SSH 部署别名:',
-      default: (a) => `${a.projectName}-server`,
-    },
-    {
-      type: 'input',
-      name: 'devDbPort',
-      message: '本地开发 DB 端口:',
-      default: '5432',
-    },
-    {
-      type: 'input',
-      name: 'devRedisPort',
-      message: '本地开发 Redis 端口:',
-      default: '6379',
-    },
-    {
-      type: 'input',
-      name: 'backendPort',
-      message: '生产 Backend 端口:',
-      default: '8001',
-    },
   ])
 
+  // Step 2: template-specific questions
+  let extra = {}
+
+  if (common.template === 'backend') {
+    extra = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'sshAlias',
+        message: 'SSH 部署别名:',
+        default: `${common.projectName}-server`,
+      },
+      {
+        type: 'input',
+        name: 'devDbPort',
+        message: '本地开发 DB 端口:',
+        default: '5432',
+      },
+      {
+        type: 'input',
+        name: 'devRedisPort',
+        message: '本地开发 Redis 端口:',
+        default: '6379',
+      },
+      {
+        type: 'input',
+        name: 'backendPort',
+        message: '生产 Backend 端口:',
+        default: '8001',
+      },
+    ])
+  }
+
+  if (common.template === 'web') {
+    extra = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'apiProxy',
+        message: 'API 代理地址 (后端):',
+        default: 'http://127.0.0.1:8000',
+      },
+    ])
+  }
+
+  const answers = { ...common, ...extra }
+
   const context = {
     ...answers,
     dbName: answers.projectName.replace(/-/g, '_'),
@@ -87,7 +103,15 @@ export async function createProject(name) {
   console.log(chalk.gray('Next steps:'))
   console.log(chalk.gray(`  cd ${context.projectName}`))
   console.log(chalk.gray('  git init && git add . && git commit -m "init"'))
-  console.log(chalk.gray('  docker compose -f docker-compose.dev.yml up -d'))
-  console.log(chalk.gray('  cd backend && uv venv && uv pip install -e ".[dev]"'))
-  console.log(chalk.gray('  cd frontend && pnpm install && pnpm dev'))
+
+  if (context.template === 'backend') {
+    console.log(chalk.gray('  docker compose -f docker-compose.dev.yml up -d'))
+    console.log(chalk.gray('  uv venv && uv pip install -e ".[dev]"'))
+    console.log(chalk.gray('  uvicorn app.main:app --reload'))
+  }
+
+  if (context.template === 'web') {
+    console.log(chalk.gray('  pnpm install'))
+    console.log(chalk.gray('  pnpm dev'))
+  }
 }

package/src/sync.js

@@ -1,92 +1,243 @@
 import fs from 'fs-extra'
 import path from 'path'
-import { ensureRepoCache, copyDir, chalk } from './utils.js'
+import inquirer from 'inquirer'
+import { ensureRepoCache, copyDir, chalk, PACKAGE_ROOT } from './utils.js'
 
-export async function syncClaude() {
-  console.log(chalk.blue('Syncing global Claude configuration...'))
+/**
+ * 从 YAML frontmatter 中提取 description 字段
+ */
+function extractDescription(content) {
+  const match = content.match(/^---\s*\n([\s\S]*?)\n---/)
+  if (!match) return ''
+  const frontmatter = match[1]
+  const descMatch = frontmatter.match(/description:\s*(.+)/)
+  return descMatch ? descMatch[1].trim().replace(/^["']|["']$/g, '') : ''
+}
 
-  const repoDir = await ensureRepoCache()
-  const sourceDir = path.join(repoDir, 'claude-cli', 'templates', 'claude-global')
-  const targetDir = path.join(process.env.HOME, '.claude')
+/**
+ * 扫描 skills 目录，返回 { name, description, sourcePath } 列表
+ */
+async function scanSkills(sourceDir) {
+  const skillsDir = path.join(sourceDir, 'skills')
+  if (!await fs.pathExists(skillsDir)) return []
 
-  if (!await fs.pathExists(sourceDir)) {
-    console.error(chalk.red('Error: claude-global templates not found in repo'))
-    process.exit(1)
+  const entries = await fs.readdir(skillsDir, { withFileTypes: true })
+  const skills = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    const skillPath = path.join(skillsDir, entry.name)
+    const skillMd = path.join(skillPath, 'SKILL.md')
+    if (!await fs.pathExists(skillMd)) continue
+
+    const content = await fs.readFile(skillMd, 'utf-8')
+    const description = extractDescription(content)
+    skills.push({
+      name: entry.name,
+      description: description || '（无描述）',
+      sourcePath: skillPath,
+      type: 'skill',
+    })
   }
 
-  const subdirs = ['rules', 'skills', 'commands', 'hooks']
-  let syncedCount = 0
+  return skills.sort((a, b) => a.name.localeCompare(b.name))
+}
 
-  for (const subdir of subdirs) {
-    const src = path.join(sourceDir, subdir)
-    if (await fs.pathExists(src)) {
-      const dest = path.join(targetDir, subdir)
-      await copyDir(src, dest)
-      const files = await fs.readdir(src).catch(() => [])
-      syncedCount += files.length
-      console.log(chalk.green(`  ✓ ${subdir}/ — ${files.length} files`))
-    }
+/**
+ * 扫描 rules 目录，返回 { name, description, sourcePath } 列表
+ */
+async function scanRules(sourceDir) {
+  const rulesDir = path.join(sourceDir, 'rules')
+  if (!await fs.pathExists(rulesDir)) return []
+
+  const entries = await fs.readdir(rulesDir, { withFileTypes: true })
+  const rules = []
+
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith('.md')) continue
+    const rulePath = path.join(rulesDir, entry.name)
+    const content = await fs.readFile(rulePath, 'utf-8')
+    const description = extractDescription(content)
+    rules.push({
+      name: entry.name.replace(/\.md$/, ''),
+      description: description || '（无描述）',
+      sourcePath: rulePath,
+      type: 'rule',
+    })
   }
 
-  // Sync CLAUDE.md
-  const claudeMdSrc = path.join(sourceDir, 'CLAUDE.md')
-  if (await fs.pathExists(claudeMdSrc)) {
-    await fs.copy(claudeMdSrc, path.join(targetDir, 'CLAUDE.md'))
+  return rules.sort((a, b) => a.name.localeCompare(b.name))
+}
+
+/**
+ * 扫描 commands 目录
+ */
+async function scanCommands(sourceDir) {
+  const commandsDir = path.join(sourceDir, 'commands')
+  if (!await fs.pathExists(commandsDir)) return []
+
+  const entries = await fs.readdir(commandsDir, { withFileTypes: true })
+  const commands = []
+
+  for (const entry of entries) {
+    if (entry.name === '.gitkeep') continue
+    commands.push({
+      name: entry.name,
+      description: entry.isDirectory() ? '命令目录' : '命令文件',
+      sourcePath: path.join(commandsDir, entry.name),
+      type: 'command',
+    })
+  }
+
+  return commands.sort((a, b) => a.name.localeCompare(b.name))
+}
+
+/**
+ * 用 inquirer 做交互式多选
+ */
+async function promptSelection(items, category) {
+  if (items.length === 0) return []
+
+  const { selected } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'selected',
+      message: `选择要同步的 ${category}（空格勾选，回车确认）：`,
+      choices: items.map(item => ({
+        name: `${chalk.cyan(item.name)} ${chalk.gray('- ' + item.description.slice(0, 60))}${item.description.length > 60 ? '...' : ''}`,
+        value: item,
+        short: item.name,
+      })),
+      pageSize: 15,
+    },
+  ])
+
+  return selected
+}
+
+/**
+ * 同步选中的文件到目标目录
+ */
+async function syncSelectedItems(items, targetDir) {
+  let syncedCount = 0
+
+  for (const item of items) {
+    const dest = path.join(targetDir, item.type + 's', item.name)
+    await fs.ensureDir(path.dirname(dest))
+    await fs.copy(item.sourcePath, dest, { overwrite: true })
     syncedCount++
-    console.log(chalk.green('  ✓ CLAUDE.md'))
+    console.log(chalk.green(`  ✓ ${item.type}s/${item.name}`))
   }
 
+  return syncedCount
+}
+
+/**
+ * 同步 settings.json（智能合并）
+ */
+async function syncSettings(sourceDir, targetDir) {
   const settingsSrc = path.join(sourceDir, 'settings.json')
-  if (await fs.pathExists(settingsSrc)) {
-    const settingsDest = path.join(targetDir, 'settings.json')
-    const newSettings = await fs.readJson(settingsSrc)
-
-    if (await fs.pathExists(settingsDest)) {
-      const existing = await fs.readJson(settingsDest)
-      // 两层深合并：顶层 key merge + dict value 二级 merge
-      const merged = { ...existing }
-      for (const [key, value] of Object.entries(newSettings)) {
-        if (key in merged && typeof merged[key] === 'object' && !Array.isArray(merged[key])
-            && typeof value === 'object' && !Array.isArray(value)) {
-          merged[key] = { ...merged[key], ...value }
-        } else {
-          merged[key] = value
-        }
+  if (!await fs.pathExists(settingsSrc)) return 0
+
+  const settingsDest = path.join(targetDir, 'settings.json')
+  const newSettings = await fs.readJson(settingsSrc)
+
+  if (await fs.pathExists(settingsDest)) {
+    const existing = await fs.readJson(settingsDest)
+    const merged = { ...existing }
+    for (const [key, value] of Object.entries(newSettings)) {
+      if (key in merged && typeof merged[key] === 'object' && !Array.isArray(merged[key])
+          && typeof value === 'object' && !Array.isArray(value)) {
+        merged[key] = { ...merged[key], ...value }
+      } else {
+        merged[key] = value
       }
-      await fs.writeJson(settingsDest, merged, { spaces: 2 })
-      console.log(chalk.green('  ✓ settings.json — merged'))
-    } else {
-      await fs.writeJson(settingsDest, newSettings, { spaces: 2 })
-      console.log(chalk.green('  ✓ settings.json — created'))
     }
-    syncedCount++
+    await fs.writeJson(settingsDest, merged, { spaces: 2 })
+    console.log(chalk.green('  ✓ settings.json — merged'))
+  } else {
+    await fs.writeJson(settingsDest, newSettings, { spaces: 2 })
+    console.log(chalk.green('  ✓ settings.json — created'))
   }
 
-  console.log(chalk.blue(`\nDone! Synced ${syncedCount} items to ~/.claude/`))
+  return 1
 }
 
-export async function syncProjectClaude() {
-  console.log(chalk.blue('Syncing project Claude configuration...'))
+/**
+ * 同步 CLAUDE.md
+ */
+async function syncClaudeMd(sourceDir, targetDir) {
+  const claudeMdSrc = path.join(sourceDir, 'CLAUDE.md')
+  if (!await fs.pathExists(claudeMdSrc)) return 0
 
-  const dwyFile = path.join(process.cwd(), '.dwy')
-  if (!await fs.pathExists(dwyFile)) {
-    console.error(chalk.red('Error: .dwy marker file not found. Is this a dwy project?'))
-    console.error(chalk.gray('Run "dwy create" to create a new project, or create .dwy manually.'))
-    process.exit(1)
+  await fs.copy(claudeMdSrc, path.join(targetDir, 'CLAUDE.md'), { overwrite: true })
+  console.log(chalk.green('  ✓ CLAUDE.md'))
+  return 1
+}
+
+/**
+ * 检测本地模板目录：如果当前是 dwy-shared monorepo，直接用本地模板
+ */
+async function resolveSourceDir() {
+  const localTemplate = path.join(process.cwd(), 'claude-cli', 'templates', 'claude-global')
+  if (await fs.pathExists(localTemplate)) {
+    console.log(chalk.gray('Using local templates from current project...'))
+    return localTemplate
   }
+  const repoDir = await ensureRepoCache()
+  return path.join(repoDir, 'claude-cli', 'templates', 'claude-global')
+}
 
-  const marker = await fs.readJson(dwyFile)
-  const template = marker.template || 'web'
+/**
+ * 主同步函数：交互式选择 + 同步到当前目录 .claude/
+ */
+export async function syncClaude() {
+  console.log(chalk.blue('\nScanning available Claude configuration...\n'))
 
-  const repoDir = await ensureRepoCache()
-  const sourceDir = path.join(repoDir, 'claude-cli', 'templates', 'project', template, '.claude')
+  const sourceDir = await resolveSourceDir()
   const targetDir = path.join(process.cwd(), '.claude')
 
   if (!await fs.pathExists(sourceDir)) {
-    console.error(chalk.red(`Error: template "${template}" not found in repo`))
+    console.error(chalk.red('Error: claude-global templates not found in repo'))
     process.exit(1)
   }
 
-  await copyDir(sourceDir, targetDir)
-  console.log(chalk.blue('Done! Synced .claude/ for current project.'))
+  // 扫描可用资源
+  const skills = await scanSkills(sourceDir)
+  const rules = await scanRules(sourceDir)
+  const commands = await scanCommands(sourceDir)
+
+  console.log(chalk.yellow(`Found ${skills.length} skills, ${rules.length} rules, ${commands.length} commands\n`))
+
+  // 交互式选择
+  const selectedSkills = await promptSelection(skills, 'Skills')
+  const selectedRules = await promptSelection(rules, 'Rules')
+  const selectedCommands = await promptSelection(commands, 'Commands')
+
+  const totalSelected = selectedSkills.length + selectedRules.length + selectedCommands.length
+  if (totalSelected === 0) {
+    console.log(chalk.yellow('\nNo items selected. Nothing to sync.'))
+    return
+  }
+
+  console.log(chalk.blue(`\nSyncing ${totalSelected} items to ${targetDir}...\n`))
+
+  await fs.ensureDir(targetDir)
+
+  let syncedCount = 0
+  syncedCount += await syncSelectedItems(selectedSkills, targetDir)
+  syncedCount += await syncSelectedItems(selectedRules, targetDir)
+  syncedCount += await syncSelectedItems(selectedCommands, targetDir)
+  syncedCount += await syncClaudeMd(sourceDir, targetDir)
+  syncedCount += await syncSettings(sourceDir, targetDir)
+
+  console.log(chalk.blue(`\nDone! Synced ${syncedCount} items to ${targetDir}`))
+}
+
+/**
+ * 保留旧的 project-claude 同步逻辑
+ */
+export async function syncProjectClaude() {
+  console.log(chalk.yellow('"dwy sync project-claude" is deprecated. Use "dwy sync claude" instead.'))
+  await syncClaude()
 }

package/templates/claude-global/CLAUDE.md

@@ -1 +1,93 @@
 所有回答必须使用中文。
+
+## 输出完整性要求
+
+- **文件路径**：必须输出完整的绝对路径（如 `/Users/chances/WebstormProjects/dwy-shared/frontend/eui/src/components/input/EInput.vue`），禁止省略为相对路径或只写文件名
+- **服务地址**：必须输出完整的 URL（如 `http://localhost:8000/api/users`），禁止省略协议、端口或路径
+- **数据库连接串**：必须输出完整连接字符串（如 `postgresql+asyncpg://user:pass@localhost:5432/mydb`），禁止只写主机名或库名
+
+## Agent 团队执行
+
+所有任务默认启用 agent team 模式执行：任务可拆分时优先并行派遣 Agent，具体派遣策略、并行度、worktree 隔离、review 闭环等由 Claude 自行判断，不在此处硬编码规则。
+
+## Behavioral Guidelines — 减少常见 LLM 编码错误的行为指南
+
+与项目特定指令合并使用。
+
+权衡：这些指南偏向谨慎而非速度。对于琐碎任务，自行判断。
+
+### 1. 先思考再编码（Think Before Coding）
+
+不要假设。不要隐藏困惑。把权衡摊开。
+
+在实现之前：
+- 明确陈述你的假设。如果不确定，就问。
+- 如果存在多种解读，提出来——不要默默选择。
+- 如果有更简单的方案，说出来。在必要时提出异议。
+- 如果有什么不清晰，停下来。说出困惑是什么。然后提问。
+
+### 2. 简单优先（Simplicity First）
+
+解决问题的最小代码。没有推测性代码。
+
+- 不做需求之外的功能。
+- 不为一次性使用的代码做抽象。
+- 不做未被要求的"灵活性"或"可配置性"。
+- 不为不可能发生的场景做错误处理。
+- 如果你写了 200 行但可以写成 50 行，重写它。
+- 问自己："一个资深工程师会说这过于复杂吗？"如果是，简化。
+
+### 3. 精准改动（Surgical Changes）
+
+只动必须动的代码。只清理自己造成的混乱。
+
+在编辑现有代码时：
+- 不要"改进"相邻的代码、注释或格式。
+- 不要重构没有问题的东西。
+- 匹配现有的风格，即使你会用不同的写法。
+- 如果发现不相关的死代码，提一下——但不要删除。
+
+当你的改动产生孤儿代码时：
+- 移除你的改动导致的未使用的 import/变量/函数。
+- 除非被要求，不要移除已有的死代码。
+
+检验标准：每一行改动的代码都应能直接追溯到用户的需求。
+
+### 4. 目标驱动执行（Goal-Driven Execution）
+
+定义成功标准。循环直到验证通过。
+
+将任务转化为可验证的目标：
+- "添加校验" → "编写无效输入的测试，然后让它们通过"
+- "修复 bug" → "编写重现 bug 的测试，然后让它通过"
+- "重构 X" → "确保测试在重构前后都通过"
+
+对于多步骤任务，陈述一个简要计划：
+1. [步骤] → 验证：[检查项]
+2. [步骤] → 验证：[检查项]
+3. [步骤] → 验证：[检查项]
+
+强成功标准让你能独立循环。弱标准（"让它工作"）需要不断澄清。
+
+这些指南在生效的标志是：diff 中不必要的改动变少，因过度复杂而重写的情况减少，澄清性问题出现在实现之前而非错误之后。
+
+## 输出精简规则
+
+输出保持精简，去掉冗余，保留技术精确性。
+
+### 核心规则
+
+- **去掉填充词**：不用"了/的/吧/吗/呢"等语气助词，不用"我认为/可能/也许/似乎"等模糊词
+- **不用客套话**：不用"你好/请/谢谢/不客气"等社交用语，直入主题
+- **允许碎片句**：不用强制完整主谓宾，短语表达即可
+- **短优先**：能用短词就不用长词，能用一句话就不用两句话
+- **技术术语精确**：变量名、函数名、错误信息、代码块等保持原样，不缩写
+- **代码块完整**：代码必须完整可运行，不受精简规则影响
+
+### 例外场景（恢复完整语气）
+
+以下场景不得精简，必须清晰明确：
+- 安全警告和风险提示
+- 不可逆操作确认（删除、强制推送等）
+- 需要用户决策的复杂多步骤流程
+- 用户明确要求详细解释时