claude-sdlc 1.0.2 → 1.0.3

package/README.md

@@ -1,9 +1,16 @@
-# claude-sdlc
+<p align="center">
+  <img src="logo-banner.svg" alt="claude-sdlc" width="700"/>
+</p>
 
-**让 Claude Code 严格按 SDLC 规范开发 — 一条命令安装，零配置开箱即用。**
+<p align="center">
+  <strong>让 Claude Code 严格按 SDLC 规范开发 — 一条命令安装，零配置开箱即用。</strong>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/claude-sdlc.svg)](https://www.npmjs.com/package/claude-sdlc)
-[![license](https://img.shields.io/npm/l/claude-sdlc.svg)](https://opensource.org/licenses/MIT)
+<p align="center">
+  <a href="https://www.npmjs.com/package/claude-sdlc"><img src="https://img.shields.io/npm/v/claude-sdlc.svg" alt="npm version"/></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/npm/l/claude-sdlc.svg" alt="license"/></a>
+  <a href="https://www.npmjs.com/package/claude-sdlc"><img src="https://img.shields.io/npm/dm/claude-sdlc.svg" alt="downloads"/></a>
+</p>
 
 ---
 
@@ -21,6 +28,12 @@ npx claude-sdlc ./my-project
 
 安装完成后，在项目目录启动 `claude` 即可自动加载全部规范。**每个项目只需安装一次。**
 
+一键卸载：
+
+```bash
+npx claude-sdlc uninstall
+```
+
 ---
 
 ## 解决什么问题
@@ -145,19 +158,20 @@ cd claude-sdlc
 ## 常见问题
 
 **已有 CLAUDE.md 会被覆盖吗？**
-不会，自动备份为 `CLAUDE.md.bak.<时间戳>`。
+会直接覆盖为最新版本。
 
 **已有 settings.json 怎么办？**
-自动智能合并 hooks 配置（去重），原文件备份。
+自动智能合并 hooks 配置（去重），保留原有配置不丢失。
 
 **可以跳过阶段吗？**
 可以，Claude 会先说明风险，确认后记录跳过原因并推进。
 
 **如何卸载？**
 ```bash
-rm CLAUDE.md
-rm -rf .claude/rules/ .claude/hooks/ .claude/commands/
+npx claude-sdlc uninstall              # 卸载当前目录
+npx claude-sdlc uninstall ./my-project # 卸载指定目录
 ```
+自动清除 CLAUDE.md、.claude/rules/、hooks/、commands/、reviews/、settings.json 中的 hooks 配置。
 
 ---
 

package/bin/cli.js

@@ -2,24 +2,34 @@
 'use strict';
 
 const path = require('path');
-const { install } = require('../lib/installer');
+const { install, uninstall } = require('../lib/installer');
 
 const pkg = require('../package.json');
 
-const HELP = `
-SDLC Enforcer v${pkg.version}
-
-让 Claude Code 严格按照 SDLC 规范开发 — 一条命令安装
-
-用法：
-  claude-sdlc [目标路径]    安装 SDLC 规范到目标项目（默认当前目录）
-  claude-sdlc --help        显示帮助
-  claude-sdlc --version     显示版本
+// 颜色
+const C = '\x1b[36m', B = '\x1b[1m', D = '\x1b[2m', R = '\x1b[0m';
+const M = '\x1b[35m', BL = '\x1b[34m', G = '\x1b[32m', RD = '\x1b[31m';
 
-示例：
-  npx claude-sdlc           # 安装到当前目录
-  npx claude-sdlc ./myapp   # 安装到指定目录
-`.trim();
+const HELP = `
+    ${C}┌─────┐${R}
+   ${C}┌┘${R} ${D}P1→P2${R} ${C}└┐${R}     ${C}${B}claude-sdlc${R} ${D}v${pkg.version}${R}
+   ${M}│${R} ${D}↑${R} ${G}✔${R}  ${D}↓${R} ${BL}│${R}     ${D}SDLC Enforcer for Claude Code${R}
+   ${M}│${R} ${D}P6  P3${R} ${BL}│${R}     ${D}by 沐谦${R}
+   ${M}└┐${R} ${D}P5←P4${R} ${BL}┌┘${R}
+    ${BL}└──▽──┘${R}
+
+  ${B}用法${R}
+    claude-sdlc ${D}[目标路径]${R}              安装到目标项目
+    claude-sdlc uninstall ${D}[目标路径]${R}    卸载全部 SDLC 文件
+    claude-sdlc --help                  显示帮助
+    claude-sdlc --version               显示版本
+
+  ${B}示例${R}
+    ${C}$${R} npx claude-sdlc                     ${D}# 安装到当前目录${R}
+    ${C}$${R} npx claude-sdlc ./myapp             ${D}# 安装到指定目录${R}
+    ${C}$${R} npx claude-sdlc uninstall           ${D}# 从当前目录卸载${R}
+    ${C}$${R} npx claude-sdlc uninstall ./myapp   ${D}# 从指定目录卸载${R}
+`.trimEnd();
 
 const args = process.argv.slice(2);
 
@@ -33,7 +43,12 @@ if (args.includes('--version') || args.includes('-v')) {
   process.exit(0);
 }
 
-const targetArg = args[0] || '.';
-const targetDir = path.resolve(targetArg);
-
-install(targetDir);
+if (args[0] === 'uninstall') {
+  const targetArg = args[1] || '.';
+  const targetDir = path.resolve(targetArg);
+  uninstall(targetDir);
+} else {
+  const targetArg = args[0] || '.';
+  const targetDir = path.resolve(targetArg);
+  install(targetDir);
+}

package/lib/installer.js

@@ -3,59 +3,84 @@
 const fs = require('fs');
 const path = require('path');
 
-// 颜色码
-const RED = '\x1b[0;31m';
-const GREEN = '\x1b[0;32m';
-const YELLOW = '\x1b[1;33m';
-const BLUE = '\x1b[0;34m';
-const NC = '\x1b[0m';
-
-function info(msg) { console.log(`${BLUE}[INFO]${NC} ${msg}`); }
-function success(msg) { console.log(`${GREEN}[OK]${NC} ${msg}`); }
-function warn(msg) { console.log(`${YELLOW}[WARN]${NC} ${msg}`); }
-function error(msg) { console.error(`${RED}[ERROR]${NC} ${msg}`); }
-
-function timestamp() {
-  const d = new Date();
-  return d.getFullYear().toString()
-    + String(d.getMonth() + 1).padStart(2, '0')
-    + String(d.getDate()).padStart(2, '0')
-    + String(d.getHours()).padStart(2, '0')
-    + String(d.getMinutes()).padStart(2, '0')
-    + String(d.getSeconds()).padStart(2, '0');
+// ── 颜色 & 样式 ──────────────────────────────────────
+const RESET   = '\x1b[0m';
+const BOLD    = '\x1b[1m';
+const DIM     = '\x1b[2m';
+const RED     = '\x1b[31m';
+const GREEN   = '\x1b[32m';
+const YELLOW  = '\x1b[33m';
+const BLUE    = '\x1b[34m';
+const MAGENTA = '\x1b[35m';
+const CYAN    = '\x1b[36m';
+const WHITE   = '\x1b[37m';
+const BG_GREEN = '\x1b[42m';
+const BG_RED   = '\x1b[41m';
+
+// ── 符号 ──────────────────────────────────────────────
+const SYM = {
+  check:  `${GREEN}✔${RESET}`,
+  cross:  `${RED}✘${RESET}`,
+  warn:   `${YELLOW}⚠${RESET}`,
+  arrow:  `${CYAN}▸${RESET}`,
+  dot:    `${DIM}·${RESET}`,
+  bar:    `${DIM}│${RESET}`,
+  corner: `${DIM}└─${RESET}`,
+  tee:    `${DIM}├─${RESET}`,
+};
+
+// ── 输出函数 ──────────────────────────────────────────
+function step(num, total, msg) {
+  console.log(`  ${DIM}[${num}/${total}]${RESET} ${msg}`);
 }
 
-/**
- * 复制目录中所有匹配指定扩展名的文件
- */
-function copyFiles(srcDir, destDir, ext, label) {
-  if (!fs.existsSync(srcDir)) return [];
-  const files = fs.readdirSync(srcDir).filter(f => f.endsWith(ext));
-  const copied = [];
-  for (const file of files) {
-    fs.copyFileSync(path.join(srcDir, file), path.join(destDir, file));
-    success(`已安装${label}：${file}`);
-    copied.push(file);
-  }
-  return copied;
+function fileLog(symbol, filePath) {
+  console.log(`        ${symbol} ${filePath}`);
 }
 
-/**
- * 提取 hook 组的唯一标识（用于去重）
- * 格式：{ matcher: "正则字符串", hooks: [{ type, command/prompt }] }
- */
+function blank() { console.log(''); }
+
+function asciiLogo(mode = 'install') {
+  const ver = require('../package.json').version;
+  const c1 = CYAN, c2 = BLUE, c3 = MAGENTA, c4 = GREEN;
+  const accent = mode === 'install' ? CYAN : RED;
+  blank();
+  console.log(`    ${c1}┌─────┐${RESET}`);
+  console.log(`   ${c1}┌┘${RESET} ${DIM}P1→P2${RESET} ${c1}└┐${RESET}    ${accent}${BOLD}claude-sdlc${RESET} ${DIM}v${ver}${RESET}`);
+  console.log(`   ${c3}│${RESET} ${DIM}↑${RESET} ${c4}✔${RESET}  ${DIM}↓${RESET} ${c2}│${RESET}    ${DIM}SDLC Enforcer for Claude Code${RESET}`);
+  console.log(`   ${c3}│${RESET} ${DIM}P6  P3${RESET} ${c2}│${RESET}    ${DIM}by 沐谦${RESET}`);
+  console.log(`   ${c3}└┐${RESET} ${DIM}P5←P4${RESET} ${c2}┌┘${RESET}`);
+  console.log(`    ${c2}└──▽──┘${RESET}`);
+  blank();
+}
+
+function banner(title, color = CYAN) {
+  const line = '─'.repeat(44);
+  blank();
+  console.log(`  ${color}${BOLD}┌${line}┐${RESET}`);
+  console.log(`  ${color}${BOLD}│${RESET}  ${color}${BOLD}${title.padEnd(42)}${RESET}${color}${BOLD}│${RESET}`);
+  console.log(`  ${color}${BOLD}└${line}┘${RESET}`);
+  blank();
+}
+
+function resultBanner(text, ok = true) {
+  const color = ok ? GREEN : RED;
+  const bg = ok ? BG_GREEN : BG_RED;
+  const icon = ok ? ' ✔ ' : ' ✘ ';
+  blank();
+  console.log(`  ${bg}${BOLD}${WHITE}${icon}${text} ${RESET}`);
+  blank();
+}
+
+// ── 工具函数 ──────────────────────────────────────────
+
 function hookGroupKey(group) {
   if (group.hooks && Array.isArray(group.hooks)) {
     return group.hooks.map(h => h.command || h.prompt).join('|');
   }
-  // 兼容旧格式
   return group.command || group.prompt || JSON.stringify(group);
 }
 
-/**
- * 智能合并 settings.json — 合并 hooks 数组（去重）
- * 格式：{ matcher: "Write|Edit", hooks: [{ type, command/prompt }] }
- */
 function mergeSettings(existing, template) {
   const hookTypes = ['PreToolUse', 'PostToolUse', 'Stop', 'PreCompact'];
   const result = JSON.parse(JSON.stringify(existing));
@@ -82,159 +107,229 @@ function mergeSettings(existing, template) {
   return result;
 }
 
-/**
- * 主安装逻辑
- */
+function copyFilesQuiet(srcDir, destDir, ext) {
+  if (!fs.existsSync(srcDir)) return [];
+  const files = fs.readdirSync(srcDir).filter(f => f.endsWith(ext));
+  for (const file of files) {
+    fs.copyFileSync(path.join(srcDir, file), path.join(destDir, file));
+  }
+  return files;
+}
+
+// ── 安装 ──────────────────────────────────────────────
+
 function install(targetDir) {
-  // 模板目录位于包的 template/ 下
   const templateDir = path.join(__dirname, '..', 'template');
+  const STEPS = 6;
 
-  // 验证目标目录
+  // 验证
   if (!fs.existsSync(targetDir)) {
-    error(`目标目录不存在：${targetDir}`);
+    console.error(`\n  ${SYM.cross} 目标目录不存在：${targetDir}\n`);
     process.exit(1);
   }
-
   if (!fs.statSync(targetDir).isDirectory()) {
-    error(`目标路径不是目录：${targetDir}`);
+    console.error(`\n  ${SYM.cross} 目标路径不是目录：${targetDir}\n`);
     process.exit(1);
   }
-
-  // 验证模板目录
   if (!fs.existsSync(templateDir)) {
-    error(`找不到 template 目录：${templateDir}`);
+    console.error(`\n  ${SYM.cross} 找不到 template 目录：${templateDir}\n`);
     process.exit(1);
   }
 
-  console.log('');
-  console.log('========================================');
-  console.log('  SDLC Enforcer 安装程序');
-  console.log('========================================');
-  console.log('');
-  info(`模板目录：${templateDir}`);
-  info(`目标项目：${targetDir}`);
-  console.log('');
-
-  // === Step 1: 备份已有的 CLAUDE.md ===
-  const claudeMdPath = path.join(targetDir, 'CLAUDE.md');
-  if (fs.existsSync(claudeMdPath)) {
-    const backupName = `CLAUDE.md.bak.${timestamp()}`;
-    const backupPath = path.join(targetDir, backupName);
-    warn(`目标项目已有 CLAUDE.md，备份为：${backupName}`);
-    fs.copyFileSync(claudeMdPath, backupPath);
-    success('已备份 CLAUDE.md');
-  }
+  asciiLogo('install');
 
-  // === Step 2: 复制 CLAUDE.md ===
-  fs.copyFileSync(path.join(templateDir, 'CLAUDE.md'), claudeMdPath);
-  success('已安装 CLAUDE.md');
+  const installLine = '─'.repeat(44);
+  console.log(`  ${CYAN}${BOLD}┌${installLine}┐${RESET}`);
+  console.log(`  ${CYAN}${BOLD}│${RESET}  ${CYAN}${BOLD}${'安 装'.padEnd(41)}${RESET}${CYAN}${BOLD}│${RESET}`);
+  console.log(`  ${CYAN}${BOLD}└${installLine}┘${RESET}`);
+  blank();
+  console.log(`  ${SYM.arrow} 目标  ${BOLD}${targetDir}${RESET}`);
+  blank();
 
-  // === Step 3: 创建 .claude 目录结构 ===
+  // Step 1: CLAUDE.md
+  step(1, STEPS, '安装核心控制文件');
+  fs.copyFileSync(
+    path.join(templateDir, 'CLAUDE.md'),
+    path.join(targetDir, 'CLAUDE.md')
+  );
+  fileLog(SYM.check, 'CLAUDE.md');
+
+  // Step 2: 目录结构
+  step(2, STEPS, '创建目录结构');
   const dirs = ['rules', 'hooks', 'commands', 'reviews'];
   for (const dir of dirs) {
     fs.mkdirSync(path.join(targetDir, '.claude', dir), { recursive: true });
+    fileLog(SYM.check, `.claude/${dir}/`);
   }
-  success('已创建 .claude/ 目录结构');
 
-  // === Step 4: 复制 rules 文件 ===
-  copyFiles(
+  // Step 3: 规则文件
+  step(3, STEPS, '安装规则文件');
+  const rules = copyFilesQuiet(
     path.join(templateDir, '.claude', 'rules'),
     path.join(targetDir, '.claude', 'rules'),
-    '.md',
-    '规则'
+    '.md'
   );
+  fileLog(SYM.check, `${rules.length} 个规则文件`);
 
-  // === Step 5: 复制 hooks 脚本 + 设置执行权限 ===
+  // Step 4: Hook 脚本
+  step(4, STEPS, '安装 Hook 脚本');
   const hooksSrcDir = path.join(templateDir, '.claude', 'hooks');
   const hooksDestDir = path.join(targetDir, '.claude', 'hooks');
+  let hookCount = 0;
   if (fs.existsSync(hooksSrcDir)) {
     const hookFiles = fs.readdirSync(hooksSrcDir).filter(f => f.endsWith('.sh'));
     for (const file of hookFiles) {
       const destPath = path.join(hooksDestDir, file);
       fs.copyFileSync(path.join(hooksSrcDir, file), destPath);
-      try {
-        fs.chmodSync(destPath, 0o755);
-      } catch (_) {
-        // Windows 下 chmod 可能不支持，忽略
-      }
-      success(`已安装 Hook：${file}`);
+      try { fs.chmodSync(destPath, 0o755); } catch (_) {}
+      hookCount++;
     }
   }
+  fileLog(SYM.check, `${hookCount} 个 Hook 脚本`);
 
-  // === Step 6: 复制 commands ===
-  copyFiles(
+  // Step 5: 斜杠命令
+  step(5, STEPS, '安装斜杠命令');
+  const cmds = copyFilesQuiet(
     path.join(templateDir, '.claude', 'commands'),
     path.join(targetDir, '.claude', 'commands'),
-    '.md',
-    '命令'
+    '.md'
   );
+  fileLog(SYM.check, `${cmds.length} 个命令 — ${DIM}/phase /status /checkpoint /review${RESET}`);
 
-  // === Step 7: 智能合并 settings.json ===
+  // Step 6: settings.json
+  step(6, STEPS, '配置 Hooks');
   const targetSettings = path.join(targetDir, '.claude', 'settings.json');
   const sourceSettings = path.join(templateDir, '.claude', 'settings.json');
 
   if (fs.existsSync(targetSettings)) {
-    warn('目标项目已有 .claude/settings.json');
-
     try {
       const existing = JSON.parse(fs.readFileSync(targetSettings, 'utf-8'));
       const template = JSON.parse(fs.readFileSync(sourceSettings, 'utf-8'));
-
-      // 备份原文件
-      const backupName = `settings.json.bak.${timestamp()}`;
-      const backupPath = path.join(targetDir, '.claude', backupName);
-      fs.copyFileSync(targetSettings, backupPath);
-      warn(`已备份原 settings.json 为：${backupName}`);
-
-      // 智能合并
       const merged = mergeSettings(existing, template);
       fs.writeFileSync(targetSettings, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
-      success('已智能合并 settings.json（保留原有配置）');
+      fileLog(SYM.check, `settings.json ${DIM}(智能合并，保留原有配置)${RESET}`);
     } catch (e) {
-      warn(`合并失败（${e.message}），将覆盖安装 settings.json`);
       fs.copyFileSync(sourceSettings, targetSettings);
-      success('已安装 settings.json（覆盖）');
+      fileLog(SYM.warn, `settings.json ${DIM}(合并失败，已覆盖安装)${RESET}`);
     }
   } else {
     fs.copyFileSync(sourceSettings, targetSettings);
-    success('已安装 settings.json');
+    fileLog(SYM.check, 'settings.json');
+  }
+
+  // 完成
+  resultBanner('安装完成');
+
+  // 文件树
+  console.log(`  ${DIM}已安装 ${rules.length + hookCount + cmds.length + 2} 个文件：${RESET}`);
+  blank();
+  console.log(`  ${BOLD}${path.basename(targetDir)}/${RESET}`);
+  console.log(`  ${SYM.tee} CLAUDE.md              ${DIM}核心控制文件${RESET}`);
+  console.log(`  ${SYM.corner} ${BOLD}.claude/${RESET}`);
+  console.log(`     ${SYM.tee} settings.json       ${DIM}Hooks 配置${RESET}`);
+  console.log(`     ${SYM.tee} ${BOLD}rules/${RESET}              ${DIM}${rules.length} 个规则 (自动加载)${RESET}`);
+  console.log(`     ${SYM.tee} ${BOLD}hooks/${RESET}              ${DIM}${hookCount} 个拦截脚本${RESET}`);
+  console.log(`     ${SYM.tee} ${BOLD}commands/${RESET}           ${DIM}${cmds.length} 个斜杠命令${RESET}`);
+  console.log(`     ${SYM.corner} ${BOLD}reviews/${RESET}           ${DIM}审查报告${RESET}`);
+  blank();
+
+  // 使用提示
+  const line = '─'.repeat(44);
+  console.log(`  ${DIM}${line}${RESET}`);
+  console.log(`  ${CYAN}使用方法${RESET}`);
+  console.log(`  ${DIM}${line}${RESET}`);
+  blank();
+  console.log(`  ${BOLD}1.${RESET} cd ${CYAN}${targetDir}${RESET}`);
+  console.log(`  ${BOLD}2.${RESET} 启动 ${CYAN}claude${RESET} 即可自动加载 SDLC 规范`);
+  console.log(`  ${BOLD}3.${RESET} 使用 ${CYAN}/phase${RESET}  查看当前阶段`);
+  console.log(`  ${BOLD}4.${RESET} 使用 ${CYAN}/status${RESET} 查看项目状态`);
+  blank();
+  console.log(`  ${DIM}卸载：npx claude-sdlc uninstall${RESET}`);
+  blank();
+}
+
+// ── 卸载 ──────────────────────────────────────────────
+
+function uninstall(targetDir) {
+  if (!fs.existsSync(targetDir)) {
+    console.error(`\n  ${SYM.cross} 目标目录不存在：${targetDir}\n`);
+    process.exit(1);
+  }
+
+  asciiLogo('uninstall');
+
+  const uninstallLine = '─'.repeat(44);
+  console.log(`  ${RED}${BOLD}┌${uninstallLine}┐${RESET}`);
+  console.log(`  ${RED}${BOLD}│${RESET}  ${RED}${BOLD}${'卸 载'.padEnd(41)}${RESET}${RED}${BOLD}│${RESET}`);
+  console.log(`  ${RED}${BOLD}└${uninstallLine}┘${RESET}`);
+  blank();
+  console.log(`  ${SYM.arrow} 目标  ${BOLD}${targetDir}${RESET}`);
+  blank();
+
+  const removed = [];
+
+  // CLAUDE.md
+  const claudeMd = path.join(targetDir, 'CLAUDE.md');
+  if (fs.existsSync(claudeMd)) {
+    fs.unlinkSync(claudeMd);
+    removed.push('CLAUDE.md');
+    fileLog(SYM.check, `${DIM}删除${RESET} CLAUDE.md`);
+  }
+
+  // .claude 子目录
+  const removeDirs = ['rules', 'hooks', 'commands', 'reviews'];
+  for (const dir of removeDirs) {
+    const dirPath = path.join(targetDir, '.claude', dir);
+    if (fs.existsSync(dirPath)) {
+      const count = fs.readdirSync(dirPath).length;
+      fs.rmSync(dirPath, { recursive: true });
+      removed.push(`.claude/${dir}/`);
+      fileLog(SYM.check, `${DIM}删除${RESET} .claude/${dir}/ ${DIM}(${count} 个文件)${RESET}`);
+    }
   }
 
-  // === Step 8: 安装完成 ===
-  console.log('');
-  console.log('========================================');
-  console.log(`  ${GREEN}安装完成！${NC}`);
-  console.log('========================================');
-  console.log('');
-  console.log('已安装的文件：');
-  console.log(`  ${targetDir}/`);
-  console.log('  ├── CLAUDE.md                    (核心控制文件 ~100行，自动加载)');
-  console.log('  └── .claude/');
-  console.log('      ├── settings.json            (Hooks 配置)');
-  console.log('      ├── reviews/                  (审查报告持久化)');
-  console.log('      ├── rules/                   (详细规则，自动加载)');
-  console.log('      │   ├── 01-lifecycle-phases.md');
-  console.log('      │   ├── 02-coding-standards.md');
-  console.log('      │   ├── 03-testing-standards.md');
-  console.log('      │   ├── 04-git-workflow.md');
-  console.log('      │   ├── 05-anti-amnesia.md');
-  console.log('      │   ├── 06-review-tools.md');
-  console.log('      │   └── 07-parallel-agents.md');
-  console.log('      ├── hooks/                   (运行时拦截)');
-  console.log('      │   ├── check-phase-write.sh');
-  console.log('      │   └── check-phase-test.sh');
-  console.log('      └── commands/                (斜杠命令)');
-  console.log('          ├── phase.md             (/phase)');
-  console.log('          ├── checkpoint.md        (/checkpoint)');
-  console.log('          ├── status.md            (/status)');
-  console.log('          └── review.md            (/review)');
-  console.log('');
-  console.log('使用方法：');
-  console.log(`  1. cd ${targetDir}`);
-  console.log('  2. 启动 claude 即可自动加载 SDLC 规范');
-  console.log('  3. 使用 /phase 查看当前阶段');
-  console.log('  4. 使用 /status 查看项目状态');
-  console.log('');
+  // settings.json
+  const settingsPath = path.join(targetDir, '.claude', 'settings.json');
+  if (fs.existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+      if (settings.hooks) {
+        delete settings.hooks;
+      }
+      if (Object.keys(settings).length === 0) {
+        fs.unlinkSync(settingsPath);
+        removed.push('settings.json');
+        fileLog(SYM.check, `${DIM}删除${RESET} .claude/settings.json`);
+      } else {
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+        removed.push('settings.json (hooks)');
+        fileLog(SYM.check, `${DIM}清理${RESET} settings.json ${DIM}(仅移除 hooks，保留其他配置)${RESET}`);
+      }
+    } catch (_) {
+      fs.unlinkSync(settingsPath);
+      removed.push('settings.json');
+      fileLog(SYM.check, `${DIM}删除${RESET} .claude/settings.json`);
+    }
+  }
+
+  // 清理空 .claude 目录
+  const claudeDir = path.join(targetDir, '.claude');
+  if (fs.existsSync(claudeDir)) {
+    const remaining = fs.readdirSync(claudeDir);
+    if (remaining.length === 0) {
+      fs.rmdirSync(claudeDir);
+      fileLog(SYM.check, `${DIM}删除${RESET} .claude/ ${DIM}(空目录)${RESET}`);
+    }
+  }
+
+  if (removed.length > 0) {
+    resultBanner(`卸载完成 — 已清理 ${removed.length} 项`);
+    console.log(`  ${DIM}重新安装：npx claude-sdlc${RESET}`);
+  } else {
+    blank();
+    console.log(`  ${SYM.warn} 未找到 SDLC Enforcer 安装的文件`);
+  }
+  blank();
 }
 
-module.exports = { install, mergeSettings };
+module.exports = { install, uninstall, mergeSettings };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-sdlc",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "让 Claude Code 严格按 SDLC 规范开发 — 一条命令安装",
   "bin": {
     "claude-sdlc": "./bin/cli.js"
@@ -16,5 +16,6 @@
     "development-workflow",
     "ai-coding"
   ],
+  "author": "沐谦",
   "license": "MIT"
 }