claude-sdlc 1.0.0

package/README.md

@@ -0,0 +1,317 @@
+# SDLC Enforcer for Claude Code
+
+**让 Claude Code 严格按照软件开发生命周期（SDLC）规范进行开发。**
+
+自动加载、自动识别任务、自动驱动全流程、运行时拦截、抗上下文压缩——零配置，开箱即用。
+
+---
+
+## 解决什么问题
+
+| 问题 | 解决方案 |
+|------|---------|
+| Claude Code 不遵循开发流程，直接写代码 | SDLC 六阶段强制流程（需求→设计→编码→测试→审查→交付） |
+| 需要用户反复输入指令推进流程 | **自动驱动模式**：确认 PRD 和设计后，P3→P6 全自动完成 |
+| 规范需要手动每次提醒 | CLAUDE.md + rules/ 自动加载，Hooks 运行时拦截 |
+| Claude Code 无法自动识别规范 | CLAUDE.md 启动指令自动初始化 + 任务自动识别 |
+| Claude 自行添加/减少功能 | **PRD 驱动开发**：严格按需求清单执行，每行代码对应 PRD |
+| 长对话后 Claude 忘记规范（context compaction） | 七层防御机制 + `# Compact Instructions` + CLAUDE.md 活文档 |
+| CLAUDE.md 太长导致指令遵循率下降 | **精简到 ~100 行**，详细规则拆分到 rules/（自动加载） |
+
+## 核心特性
+
+- **自动驱动模式**：用户只需确认 PRD 和设计方案，P3 编码→P4 测试→P5 集成审查→P6 交付全自动完成
+- **PRD 驱动开发**：P1 产出编号化需求清单，全流程以 PRD 为唯一依据，禁止自行添加/减少
+- **六阶段 SDLC 流程**：P1 需求分析 → P2 系统设计 → P3 编码实现 → P4 测试验证 → P5 集成审查 → P6 部署交付
+- **每阶段独立审查**：每个阶段都有专项 Review，审查通过才推进（自动驱动模式下自动执行）
+- **自动修复重试**：审查未通过时自动修复并重试（最多 3 次），超过才请求用户帮助
+- **运行时拦截**：Hooks 自动拦截当前阶段不允许的操作（写代码、测试、git 提交）
+- **抗压缩**：`# Compact Instructions` + PreCompact hook，compaction 后自动恢复并继续自动驱动
+- **精简 CLAUDE.md**：核心控制文件仅 ~100 行，指令遵循率最优；详细规则通过 rules/ 自动加载
+- **斜杠命令**：`/phase`、`/status`、`/checkpoint`、`/review`（自动驱动时通常不需要手动使用）
+
+---
+
+## 快速安装
+
+### 方式 1：npx 一条命令（推荐）
+
+```bash
+npx claude-sdlc              # 安装到当前项目
+npx claude-sdlc ./my-project # 安装到指定目录
+```
+
+### 方式 2：全局安装
+
+```bash
+npm install -g claude-sdlc
+claude-sdlc
+```
+
+### 方式 3：clone 后安装（备选）
+
+```bash
+git clone https://github.com/<your-username>/sdlc-enforcer.git
+cd sdlc-enforcer
+./install.sh /path/to/your-project
+```
+
+### 前置依赖
+
+- **Node.js >= 16**（npx / npm 方式需要）
+- **jq**（可选）：Hook 脚本优先使用 jq 解析 JSON，未安装时自动降级为 sed 解析（仍然可用）
+
+---
+
+## 安装后的文件结构
+
+```
+your-project/
+├── CLAUDE.md                          # 核心控制文件（~100行，自动加载）
+└── .claude/
+    ├── settings.json                  # Hooks 配置
+    ├── rules/                         # 详细规则（自动加载）
+    │   ├── 01-lifecycle-phases.md     # SDLC 阶段定义
+    │   ├── 02-coding-standards.md     # 编码规范
+    │   ├── 03-testing-standards.md    # 测试标准
+    │   ├── 04-git-workflow.md         # Git 工作流
+    │   ├── 05-anti-amnesia.md         # 反遗忘机制
+    │   ├── 06-review-tools.md        # 审查工具链配置
+    │   └── 07-parallel-agents.md    # 多 Agent 并行开发
+    ├── hooks/                         # 运行时拦截脚本
+    │   ├── check-phase-write.sh       # 拦截非法代码写入
+    │   └── check-phase-test.sh        # 拦截非法测试/git 执行
+    ├── reviews/                       # 审查报告持久化
+    └── commands/                      # 斜杠命令
+        ├── phase.md                   # /phase 命令
+        ├── checkpoint.md              # /checkpoint 命令
+        ├── status.md                  # /status 命令
+        └── review.md                  # /review 命令
+```
+
+### 架构设计原则
+
+| 层 | 文件 | 加载方式 | 职责 |
+|----|------|---------|------|
+| 控制层 | `CLAUDE.md` (~100行) | 自动加载 | 启动指令、核心规则摘要、项目状态 YAML、Compact Instructions |
+| 规则层 | `.claude/rules/*.md` | 自动加载 | 详细阶段定义、编码/测试/Git 规范、反遗忘机制 |
+| 拦截层 | `.claude/hooks/*.sh` | 自动触发 | PreToolUse 运行时拦截违规操作 |
+| 审查层 | `.claude/settings.json` | 自动注册 | Stop/PostToolUse/PreCompact prompt hooks |
+| 交互层 | `.claude/commands/*.md` | 用户调用 | /phase, /status, /checkpoint, /review |
+
+**精简 CLAUDE.md 的原因**：官方文档指出，CLAUDE.md 越短指令遵循率越高。详细规则通过 rules/ 自动加载，无需在 CLAUDE.md 中重复。
+
+---
+
+## 使用指南
+
+### 开始开发
+
+在目标项目目录启动 Claude Code：
+
+```bash
+cd your-project
+claude
+```
+
+Claude 会自动加载 SDLC 规范。**当你提出开发任务时（如"帮我实现..."），Claude 会自动进入 P1（需求分析），无需手动操作。**
+
+### 自动驱动模式（核心特性）
+
+**用户只需两次确认，其余全自动：**
+
+```
+你说"帮我实现XX"
+  ↓ 自动
+P1 需求分析 → Claude 整理 PRD → 【你确认 PRD】
+  ↓ 自动
+P2 系统设计 → Claude 设计方案 → 【你确认设计】
+  ↓ 自动（以下全自动，你不需要操作）
+P3 编码 → 自动审查 → P4 测试 → 自动审查 → P5 集成 → 自动审查 → P6 交付 → 完成报告
+```
+
+- P1/P2：Claude 做分析，你确认方案，仅此而已
+- P3→P6：Claude 自动编码、测试、审查、交付，你坐等结果
+- 审查失败时 Claude 自动修复重试（最多 3 次），超过才请求你帮助
+- 你随时可以介入（输入任何消息即可）
+
+### 可用命令（通常不需要手动使用）
+
+```
+/phase           # 查看当前阶段进度
+/phase next      # 手动推进阶段（自动驱动模式下不需要）
+/phase back      # 回退到上一阶段
+/status          # 查看全面的项目状态报告
+/checkpoint      # 保存状态快照（建议长对话时定期使用）
+/review                    # 手动触发当前阶段审查
+/review src/auth/login.ts  # 审查指定文件（P3+ 阶段）
+```
+
+### SDLC 六阶段说明
+
+| 阶段 | 名称 | 核心活动 | 阶段审查 | 推进方式 |
+|------|------|---------|---------|---------|
+| **P1** | 需求分析 | 理解需求、整理 PRD | 需求审查 | 用户确认 PRD |
+| **P2** | 系统设计 | 架构设计、实现规划 | 设计审查 | 用户确认设计 |
+| **P3** | 编码实现 | 按 PRD 编写代码 | 代码审查(含工具链) | **自动驱动** |
+| **P4** | 测试验证 | 按 PRD 编写/执行测试 | 测试审查(含覆盖率) | **自动驱动** |
+| **P5** | 集成审查 | 全局审查、四环追溯 | 集成审查 | **自动驱动** |
+| **P6** | 部署交付 | Git 提交、交付报告 | 交付审查 | **自动完成** |
+
+### 工具辅助审查（生产级特性）
+
+`/review` 不仅依赖 LLM 判断，还会**自动运行真实工具链**，用客观数据辅助审查：
+
+- **自动检测项目类型** — 根据 `package.json`、`pyproject.toml`、`go.mod`、`Cargo.toml` 等文件自动识别项目类型，运行对应的 Lint/Typecheck/Build/Audit 工具
+- **工具未安装时自动安装** — 检测到所需工具未安装时，自动安装为 devDependency（如 `npm install --save-dev eslint`）；安装失败时降级跳过，不阻塞审查
+- **真实数据驱动** — Lint 错误数、Typecheck 错误数、构建结果、依赖漏洞数、测试通过率、代码覆盖率均来自工具实际输出，非 LLM 估算
+- **审查报告持久化** — 每次 `/review` 的完整报告（含工具输出原文）写入 `.claude/reviews/P{n}-review-{时间}.md`，可追溯
+
+详细配置见 `.claude/rules/06-review-tools.md`。
+
+### 多 Agent 并行开发
+
+P3/P4/P5 阶段支持多 Agent 并行工作，利用 Claude Code 的 Task 工具提高开发效率：
+
+- **P3 并行编码** — 独立模块由不同子 Agent 同时编写，主 Agent 协调接口一致性
+- **P4 并行测试** — 不同模块的测试由不同子 Agent 同时编写，主 Agent 统一执行验证
+- **P5 并行审查** — 全局一致性、性能、PRD 追溯三个维度由不同子 Agent 同时审查
+
+并行开发不适用于：P1/P2（需用户交互）、P6（git 串行）、模块间有依赖时。
+
+详细规则见 `.claude/rules/07-parallel-agents.md`。
+
+---
+
+## 自动执行 — 无需人为干预
+
+本系统的设计目标：**Claude 在任何情况下都能自己读取规范、按规范执行**，用户不需要提醒。
+
+### 七层防御机制
+
+| 层 | 机制 | 类型 | 作用 |
+|----|------|------|------|
+| 1 | CLAUDE.md 启动指令 | 主动 | 每次加载时自动执行状态检查和初始化 |
+| 2 | rules/ 规则文件 | 主动 | 详细规范自动加载，compaction 后重新加载 |
+| 3 | PreToolUse Hooks | 被动 | 硬拦截违规操作（写代码/测试/git），不依赖 Claude 自觉 |
+| 4 | PostToolUse Hook | 主动 | 每次文件修改后提醒更新 CLAUDE.md 状态 |
+| 5 | Stop Hook | 主动 | 每次回复后强制自检合规性 + 自动驱动推进 |
+| 6 | PreCompact Hook | 主动 | 压缩前强制保存所有状态到 CLAUDE.md |
+| 7 | 用户命令 | 按需 | /status、/checkpoint、/phase、/review |
+
+### 端到端自动化流程
+
+```
+用户说"帮我实现X"
+     ↓
+CLAUDE.md 启动指令自动识别 → 进入 P1
+     ↓
+P1 需求分析 → 整理 PRD → 用户确认 → 自动审查 → 进入 P2
+     ↓
+P2 系统设计 → 设计方案 → 用户确认 → 自动审查 → 进入 P3
+     ↓
+══════════ 自动驱动模式启动 ══════════
+     ↓
+P3 编码 → 代码审查 → 通过 → P4 测试 → 测试审查 → 通过 → P5 集成审查 → 通过 → P6 交付 → 完成
+     │                        │                        │
+     └── 审查失败：自动修复    └── 审查失败：自动修复    └── 审查失败：自动修复
+         重试（最多3次）           重试（最多3次）           重试（最多3次）
+     ↓
+输出交付摘要（PRD 完成率、修改文件、测试结果、Git 提交）
+```
+
+全程每次回复 → Stop Hook 强制自检 + 自动驱动推进
+全程每次工具调用 → PreToolUse Hook 拦截违规
+全程每次文件修改 → PostToolUse Hook 同步状态
+Context Compaction 时 → PreCompact Hook 保存状态 → 自动恢复后继续
+
+---
+
+## 自定义配置
+
+### 修改阶段定义
+
+编辑 `.claude/rules/01-lifecycle-phases.md`，可以修改每个阶段的入口/退出条件。
+
+### 修改编码规范
+
+编辑 `.claude/rules/02-coding-standards.md`，根据团队习惯调整命名、格式等规范。
+
+### 添加新的规则文件
+
+在 `.claude/rules/` 目录下添加新的 `.md` 文件，会自动被 Claude Code 加载。
+
+### 调整 Hook 拦截规则
+
+编辑 `.claude/hooks/` 下的脚本，修改文件类型白名单或命令模式匹配。
+
+### 添加新的斜杠命令
+
+在 `.claude/commands/` 下添加新的 `.md` 文件即可注册新命令。
+
+---
+
+## 工作原理
+
+```
+Claude Code 启动
+     ↓
+自动加载 CLAUDE.md (~100行) → 启动指令 + 核心规则 + 项目状态
+     ↓
+自动加载 .claude/rules/*.md → 详细阶段定义 + 编码/测试/Git 规范 + 反遗忘机制
+     ↓
+自动注册 .claude/settings.json 中的 Hooks
+     ↓
+自动注册 .claude/commands/*.md 为斜杠命令
+     ↓
+开始工作（受规范约束）
+     │
+     ├── 每次工具调用 → PreToolUse Hook 检查阶段合规性
+     ├── 每次文件修改 → PostToolUse Hook 同步状态到 CLAUDE.md
+     ├── 每次回复后 → Stop Hook 自检 + 自动驱动推进
+     └── Context Compaction 前 → PreCompact Hook 保存状态
+```
+
+### 为什么精简 CLAUDE.md？
+
+| 对比 | 旧版 (~285行) | 新版 (~100行) |
+|------|-------------|-------------|
+| 详细规则 | 全部写在 CLAUDE.md 中 | 拆分到 rules/ 自动加载 |
+| 指令遵循率 | 随长度增加而下降 | 精简核心，遵循率更高 |
+| Compaction 影响 | 信息过多可能被压缩遗漏 | 关键信息集中，不易遗漏 |
+| 维护性 | 单文件维护困难 | 模块化，各规则独立维护 |
+
+---
+
+## 常见问题
+
+### Hook 报错"jq: command not found"
+
+安装 jq：`brew install jq`（macOS）或 `sudo apt-get install jq`（Ubuntu）。无 jq 时 hooks 自动降级为 sed 解析。
+
+### 已有 CLAUDE.md 会被覆盖吗？
+
+不会。安装脚本会先将已有的 CLAUDE.md 备份为 `CLAUDE.md.bak.<时间戳>`。
+
+### 已有 settings.json 会被覆盖吗？
+
+如果安装了 jq，脚本会智能合并 hooks 配置。否则会备份原文件后覆盖。
+
+### 可以跳过某个阶段吗？
+
+可以，但 Claude 会先说明跳过的风险。用户坚持则记录跳过原因后强制推进。
+
+### 如何卸载？
+
+删除以下文件即可：
+```bash
+rm CLAUDE.md
+rm -rf .claude/rules/ .claude/hooks/ .claude/commands/
+# 如需要，手动从 .claude/settings.json 中移除 SDLC 相关的 hooks
+```
+
+---
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { install } = 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     显示版本
+
+示例：
+  npx claude-sdlc           # 安装到当前目录
+  npx claude-sdlc ./myapp   # 安装到指定目录
+`.trim();
+
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(HELP);
+  process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+const targetArg = args[0] || '.';
+const targetDir = path.resolve(targetArg);
+
+install(targetDir);

package/lib/installer.js

@@ -0,0 +1,224 @@
+'use strict';
+
+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');
+}
+
+/**
+ * 复制目录中所有匹配指定扩展名的文件
+ */
+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;
+}
+
+/**
+ * 智能合并 settings.json — 合并 hooks 数组（去重）
+ */
+function mergeSettings(existing, template) {
+  const hookTypes = ['PreToolUse', 'PostToolUse', 'Stop', 'PreCompact'];
+  const result = JSON.parse(JSON.stringify(existing));
+
+  for (const type of hookTypes) {
+    const existingHooks = result.hooks?.[type] || [];
+    const newHooks = template.hooks?.[type] || [];
+
+    const merged = [...existingHooks];
+    for (const hook of newHooks) {
+      const key = hook.command || hook.prompt;
+      if (!merged.some(h => (h.command || h.prompt) === key)) {
+        merged.push(hook);
+      }
+    }
+
+    if (!result.hooks) result.hooks = {};
+    result.hooks[type] = merged;
+  }
+
+  return result;
+}
+
+/**
+ * 主安装逻辑
+ */
+function install(targetDir) {
+  // 模板目录位于包的 template/ 下
+  const templateDir = path.join(__dirname, '..', 'template');
+
+  // 验证目标目录
+  if (!fs.existsSync(targetDir)) {
+    error(`目标目录不存在：${targetDir}`);
+    process.exit(1);
+  }
+
+  if (!fs.statSync(targetDir).isDirectory()) {
+    error(`目标路径不是目录：${targetDir}`);
+    process.exit(1);
+  }
+
+  // 验证模板目录
+  if (!fs.existsSync(templateDir)) {
+    error(`找不到 template 目录：${templateDir}`);
+    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');
+  }
+
+  // === Step 2: 复制 CLAUDE.md ===
+  fs.copyFileSync(path.join(templateDir, 'CLAUDE.md'), claudeMdPath);
+  success('已安装 CLAUDE.md');
+
+  // === Step 3: 创建 .claude 目录结构 ===
+  const dirs = ['rules', 'hooks', 'commands', 'reviews'];
+  for (const dir of dirs) {
+    fs.mkdirSync(path.join(targetDir, '.claude', dir), { recursive: true });
+  }
+  success('已创建 .claude/ 目录结构');
+
+  // === Step 4: 复制 rules 文件 ===
+  copyFiles(
+    path.join(templateDir, '.claude', 'rules'),
+    path.join(targetDir, '.claude', 'rules'),
+    '.md',
+    '规则'
+  );
+
+  // === Step 5: 复制 hooks 脚本 + 设置执行权限 ===
+  const hooksSrcDir = path.join(templateDir, '.claude', 'hooks');
+  const hooksDestDir = path.join(targetDir, '.claude', 'hooks');
+  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}`);
+    }
+  }
+
+  // === Step 6: 复制 commands ===
+  copyFiles(
+    path.join(templateDir, '.claude', 'commands'),
+    path.join(targetDir, '.claude', 'commands'),
+    '.md',
+    '命令'
+  );
+
+  // === Step 7: 智能合并 settings.json ===
+  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（保留原有配置）');
+    } catch (e) {
+      warn(`合并失败（${e.message}），将覆盖安装 settings.json`);
+      fs.copyFileSync(sourceSettings, targetSettings);
+      success('已安装 settings.json（覆盖）');
+    }
+  } else {
+    fs.copyFileSync(sourceSettings, targetSettings);
+    success('已安装 settings.json');
+  }
+
+  // === 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('');
+}
+
+module.exports = { install, mergeSettings };

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "claude-sdlc",
+  "version": "1.0.0",
+  "description": "让 Claude Code 严格按 SDLC 规范开发 — 一条命令安装",
+  "bin": {
+    "claude-sdlc": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "template/"
+  ],
+  "keywords": [
+    "claude-code",
+    "sdlc",
+    "development-workflow",
+    "ai-coding"
+  ],
+  "license": "MIT"
+}

package/template/.claude/commands/checkpoint.md

@@ -0,0 +1,65 @@
+# /checkpoint — 保存状态快照
+
+用法：`/checkpoint [描述]`
+
+参数：$ARGUMENTS
+
+---
+
+## 执行逻辑
+
+1. **收集当前状态信息**：
+   - 读取 CLAUDE.md 中的 `current_phase`
+   - 读取 CLAUDE.md 中的 `task_description`
+   - 执行 `git status`（如果是 git 仓库）获取文件变更状态
+   - 执行 `git diff --stat`（如果是 git 仓库）获取变更统计
+
+2. **生成快照摘要**：
+   ```
+   === SDLC Checkpoint ===
+   时间：{当前时间}
+   描述：{用户提供的描述 或 "手动检查点"}
+   当前阶段：{阶段编号} — {阶段名称}
+   任务：{task_description}
+
+   已修改文件：
+   - {文件列表}
+
+   架构决策：
+   - {决策列表}
+
+   待办事项：
+   - {待办列表}
+
+   Git 状态：
+   {git status 输出摘要}
+   ========================
+   ```
+
+3. **更新 CLAUDE.md**：
+   - 确保 `modified_files` 列表是最新的
+   - 确保 `todo_items` 列表是最新的
+   - 更新 `last_updated` 时间戳
+   - 更新 `key_context` 为当前关键上下文的摘要
+
+4. **输出确认信息**：
+   ```
+   ✅ 检查点已保存。
+
+   如果后续发生上下文压缩（compaction），可以从 CLAUDE.md 恢复以下状态：
+   - 阶段：{阶段}
+   - 任务：{任务描述}
+   - 已修改 {n} 个文件
+   - {n} 项待办事项
+   ```
+
+---
+
+## 使用建议
+
+建议在以下时机使用 `/checkpoint`：
+- 完成一个重要步骤后
+- 进行长对话之前（预防 compaction）
+- 做出重要架构决策后
+- 切换工作方向之前
+- 任何你觉得"这些信息不能丢"的时候