sumulige-claude 1.0.0

package/template/.claude/templates/PROJECT_PROPOSAL.md

@@ -0,0 +1,227 @@
+# 项目计划书 (Project Proposal)
+
+> 完整技术方案与实施计划
+> 生成日期: {DATE}
+
+---
+
+## 执行摘要
+
+{EXECUTIVE_SUMMARY}
+
+---
+
+## 1. 项目背景
+
+### 1.1 问题陈述
+{PROBLEM_STATEMENT}
+
+### 1.2 解决方案概述
+{SOLUTION_OVERVIEW}
+
+### 1.3 目标用户
+{TARGET_USERS}
+
+---
+
+## 2. 功能需求
+
+### 2.1 核心功能 (MVP)
+| 功能 | 描述 | 优先级 |
+|------|------|--------|
+| {FEATURE_1} | {DESCRIPTION} | P0 |
+| {FEATURE_2} | {DESCRIPTION} | P0 |
+
+### 2.2 扩展功能
+| 功能 | 描述 | 优先级 |
+|------|------|--------|
+| {FEATURE_3} | {DESCRIPTION} | P1 |
+
+---
+
+## 3. 技术架构
+
+### 3.1 架构图
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        系统架构                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐   │
+│   │   前端层     │    │   API层     │    │   数据层     │   │
+│   │  {FRONTEND} │◄──►│  {API}      │◄──►│ {DATABASE}  │   │
+│   └─────────────┘    └─────────────┘    └─────────────┘   │
+│                             │                                │
+│                             ▼                                │
+│                    ┌─────────────┐                         │
+│                    │  外部服务    │                         │
+│                    │ {EXTERNAL}  │                         │
+│                    └─────────────┘                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 技术栈
+
+| 层级 | 技术选择 | 理由 |
+|------|----------|------|
+| **前端** | {FRONTEND_TECH} | {REASON} |
+| **后端** | {BACKEND_TECH} | {REASON} |
+| **数据库** | {DATABASE_TECH} | {REASON} |
+| **部署** | {DEPLOYMENT_TECH} | {REASON} |
+| **监控** | {MONITORING_TECH} | {REASON} |
+
+### 3.3 数据模型
+
+```typescript
+// 核心数据结构
+interface {ENTITY_NAME} {
+  id: string;
+  {FIELD}: {TYPE};
+  // ...
+}
+```
+
+### 3.4 API 设计
+
+| 方法 | 端点 | 描述 | 认证 |
+|------|------|------|------|
+| GET | /api/{RESOURCE} | 获取列表 | ✅ |
+| POST | /api/{RESOURCE} | 创建资源 | ✅ |
+| PUT | /api/{RESOURCE}/:id | 更新资源 | ✅ |
+| DELETE | /api/{RESOURCE}/:id | 删除资源 | ✅ |
+
+---
+
+## 4. 目录结构
+
+```
+{PROJECT_NAME}/
+├── docs/                  # 文档
+├── src/                   # 源代码
+│   ├── components/        # 组件
+│   ├── services/          # 服务
+│   ├── utils/             # 工具
+│   └── types/             # 类型定义
+├── tests/                 # 测试
+├── .claude/               # AI 上下文
+│   ├── CLAUDE.md          # 项目说明
+│   ├── MEMORY.md          # 增量记忆
+│   ├── PROJECT_LOG.md     # 构建历史
+│   ├── TASK_PLAN.md       # 任务计划
+│   └── skills/            # 领域技能
+└── package.json
+```
+
+---
+
+## 5. 开发计划
+
+### 5.1 迭代规划
+
+| Sprint | 目标 | 任务 | 预估 | 状态 |
+|--------|------|------|------|------|
+| Sprint 0 | 项目启动 | 架构设计、环境搭建 | 1周 | ⏳ |
+| Sprint 1 | MVP 核心 | 核心功能开发 | 2周 | ⏳ |
+| Sprint 2 | 完善 | 扩展功能、测试 | 1周 | ⏳ |
+| Sprint 3 | 优化 | 性能优化、文档 | 1周 | ⏳ |
+
+### 5.2 里程碑
+
+| 里程碑 | 交付物 | 预计日期 |
+|--------|--------|----------|
+| M0: 项目启动 | 架构文档、任务计划 | {DATE} |
+| M1: MVP | 可运行的原型 | {DATE} |
+| M2: Beta | 功能完整 | {DATE} |
+| M3: Release | 生产就绪 | {DATE} |
+
+---
+
+## 6. 质量保证
+
+### 6.1 测试策略
+- **单元测试**: 覆盖率目标 {COVERAGE}%
+- **集成测试**: 关键流程覆盖
+- **E2E 测试**: 用户场景覆盖
+
+### 6.2 代码质量
+- **Linting**: {LINTER}
+- **格式化**: {FORMATTER}
+- **代码审查**: AI Reviewer + Human 确认
+
+### 6.3 性能指标
+| 指标 | 目标 | 测量方法 |
+|------|------|----------|
+| 响应时间 | < {LATENCY}ms | 自动化测试 |
+| 吞吐量 | > {THROUGHPUT} QPS | 压力测试 |
+| 错误率 | < {ERROR_RATE}% | 监控 |
+
+---
+
+## 7. 部署计划
+
+### 7.1 环境配置
+- **开发**: 本地 Docker
+- **测试**: CI/CD 自动部署
+- **生产**: {PRODUCTION_DEPLOYMENT}
+
+### 7.2 发布流程
+1. 代码审查
+2. 测试通过
+3. Human 确认
+4. 标记版本
+5. 部署上线
+
+---
+
+## 8. 风险与缓解
+
+| 风险 | 影响 | 可能性 | 缓解措施 |
+|------|------|--------|----------|
+| {RISK_1} | 高 | 中 | {MITIGATION_1} |
+| {RISK_2} | 中 | 低 | {MITIGATION_2} |
+
+---
+
+## 9. 成功指标
+
+### 9.1 技术指标
+- 代码测试覆盖率 > {TARGET}%
+- 构建时间 < {TARGET}min
+- 部署频率 > {TARGET}/week
+
+### 9.2 业务指标
+- {BUSINESS_METRIC_1}
+- {BUSINESS_METRIC_2}
+
+---
+
+## 10. 后续规划
+
+### 10.1 短期 (3个月)
+{SHORT_TERM_PLANS}
+
+### 10.2 中期 (6个月)
+{MID_TERM_PLANS}
+
+### 10.3 长期 (1年)
+{LONG_TERM_PLANS}
+
+---
+
+## 附录
+
+### A. 术语表
+| 术语 | 定义 |
+|------|------|
+| {TERM} | {DEFINITION} |
+
+### B. 参考资料
+- {REFERENCE_1}
+- {REFERENCE_2}
+
+---
+
+**文档版本**: v1.0
+**最后更新**: {DATE}
+**状态**: ⏳ 待 Human 确认

package/template/.claude/templates/TASK_PLAN.md

@@ -0,0 +1,121 @@
+# 任务执行计划 (Task Execution Plan)
+
+> 本文件由 AI 在项目启动时生成，执行时持续更新
+> 关联文件: PROJECT_KICKOFF.md, ARCHITECTURE.md
+
+---
+
+## 任务概览
+
+```
+总任务数: {TOTAL_TASKS} | 已完成: {COMPLETED} | 进行中: {IN_PROGRESS} | 待开始: {PENDING}
+进度: {PERCENTAGE}%
+```
+
+---
+
+## 任务分解 (WBS)
+
+### Phase 1: {PHASE_1_NAME}
+| ID | 任务 | 依赖 | 预估 | 优先级 | 状态 | 负责Agent |
+|----|------|------|------|--------|------|-----------|
+| T1.1 | {TASK_NAME} | - | {EST} | P0 | ⏳ | {AGENT} |
+| T1.2 | {TASK_NAME} | T1.1 | {EST} | P0 | ⏳ | {AGENT} |
+
+### Phase 2: {PHASE_2_NAME}
+| ID | 任务 | 依赖 | 预估 | 优先级 | 状态 | 负责Agent |
+|----|------|------|------|--------|------|-----------|
+| T2.1 | {TASK_NAME} | T1.2 | {EST} | P1 | ⏳ | {AGENT} |
+
+### Phase 3: {PHASE_3_NAME}
+| ID | 任务 | 依赖 | 预估 | 优先级 | 状态 | 负责Agent |
+|----|------|------|------|--------|------|-----------|
+| T3.1 | {TASK_NAME} | T2.1 | {EST} | P2 | ⏳ | {AGENT} |
+
+---
+
+## 依赖关系图
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        任务依赖图                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   [T1.1] ──► [T1.2] ──► [T1.3]                            │
+│                │                                            │
+│                └───► [T2.1] ──► [T2.2]                     │
+│                         │                                  │
+│                         └───► [T3.1]                       │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 里程碑
+
+| 里程碑 | 包含任务 | 预计完成 | 实际完成 | 状态 |
+|--------|----------|----------|----------|------|
+| M1: {MILESTONE} | T1.1-T1.3 | {DATE} | - | ⏳ |
+| M2: {MILESTONE} | T2.1-T2.2 | {DATE} | - | ⏳ |
+| M3: {MILESTONE} | T3.1 | {DATE} | - | ⏳ |
+
+---
+
+## 风险登记
+
+| 风险 | 可能性 | 影响 | 缓解措施 | 状态 |
+|------|--------|------|----------|------|
+| {RISK} | 高/中/低 | 高/中/低 | {MITIGATION} | 🟡 |
+
+---
+
+## 执行日志
+
+### {DATE}
+- **T1.1 完成**: {NOTES}
+- **T1.2 启动**: {NOTES}
+
+---
+
+## Agent 分配规则
+
+| Agent | 擅长任务 | 默认分配 |
+|-------|----------|----------|
+| **Conductor** | 任务分解、依赖分析、风险评估 | Phase 启动 |
+| **Architect** | 架构设计、技术选型、接口定义 | 架构相关任务 |
+| **Builder** | 功能实现、单元测试、Bug 修复 | 开发任务 |
+| **Reviewer** | 代码审查、质量检查、性能优化 | 审查任务 |
+| **Librarian** | 文档编写、知识整理、注释更新 | 文档任务 |
+
+---
+
+## 检查点策略
+
+| 检查点 | 触发条件 | Human 确认 |
+|--------|----------|------------|
+| CP1 | Phase 1 完成 | ✅ 必需 |
+| CP2 | 架构变更 | ✅ 必需 |
+| CP3 | 数据模型变更 | ✅ 必需 |
+| CP4 | 里程碑完成 | ✅ 确认 |
+
+---
+
+## 状态图例
+
+| 图例 | 含义 |
+|------|------|
+| ⏳ | 待开始 (Pending) |
+| 🔄 | 进行中 (In Progress) |
+| ✅ | 已完成 (Completed) |
+| ⏸️ | 阻塞 (Blocked) |
+| ❌ | 取消 (Cancelled) |
+| 🛑 | 等待确认 (Waiting for Human) |
+
+---
+
+## 下一步行动
+
+1. **当前任务**: {CURRENT_TASK}
+2. **阻塞问题**: {BLOCKERS}
+3. **需要决策**: {DECISIONS_NEEDED}

package/template/.claude/thinking-routes/QUICKREF.md

@@ -0,0 +1,98 @@
+# 对话历史速查卡
+
+> 快速找到你的对话记录
+
+---
+
+## 🚀 最常用
+
+| 命令 | 效果 |
+|------|------|
+| `tl` | 查看今日对话摘要 |
+| `log` | 查看项目完整日志 |
+| `memory` | 查看最近变更 |
+
+---
+
+## 📂 数据位置
+
+```
+.claude/
+├── thinking-routes/
+│   └── .conversation-flow.json    ← 对话流数据
+├── MEMORY.md                       ← 增量记忆
+├── PROJECT_LOG.md                  ← 完整日志
+└── ANCHORS.md                      ← 快速索引
+```
+
+---
+
+## 🔍 查找方式
+
+### 按时间查找
+```bash
+# 最近对话摘要
+.claude/hooks/tl-summary.sh
+
+# 完整项目日志（按时间顺序）
+cat .claude/PROJECT_LOG.md | grep "2026-01-11"
+```
+
+### 按关键词查找
+```bash
+# 搜索思维节点
+npx -p tsx tsx .claude/thinking-routes/index.ts search "数据分析"
+
+# 在日志中搜索
+cat .claude/PROJECT_LOG.md | grep -i "API"
+```
+
+### 按类型查找
+```bash
+# 查看所有决策
+cat .claude/PROJECT_LOG.md | grep "决策"
+
+# 查看所有变更
+cat .claude/MEMORY.md | grep "新增"
+```
+
+---
+
+## ⚡ 快捷别名
+
+添加到 `~/.zshrc` 或 `~/.bashrc`：
+
+```bash
+# 对话历史
+alias tl='.claude/hooks/tl-summary.sh'
+alias log='less .claude/PROJECT_LOG.md'
+alias memory='cat .claude/MEMORY.md'
+
+# 思维节点
+alias tl-recent='npx -p tsx tsx .claude/thinking-routes/index.ts recent'
+alias tl-graph='npx -p tsx tsx .claude/thinking-routes/index.ts log --graph'
+alias tl-search='npx -p tsx tsx .claude/thinking-routes/index.ts search'
+```
+
+---
+
+## 📱 Claude Code 内置
+
+```bash
+# 查看对话历史列表
+claude-code history
+
+# 恢复某个对话
+claude-code resume <conversation-id>
+```
+
+---
+
+## 💡 使用建议
+
+| 场景 | 使用 |
+|------|------|
+| 每天回顾 | `tl` |
+| 找决策理由 | `tl-search "关键词"` |
+| 了解项目全貌 | `log` |
+| 查看最近变更 | `memory` |

package/template/CLAUDE-template.md

@@ -0,0 +1,114 @@
+# [项目名称] - AI 协作配置
+
+> 本文件由 AI 自动维护，定义 AI 协作方式和项目规范
+> 最后更新：YYYY-MM-DD
+
+---
+
+## 🚀 AI 启动检查清单（每次任务开始前执行）
+
+1. **加载锚点索引**：`.claude/ANCHORS.md` → 快速定位模块
+2. **阅读项目范式**：`prompts/project-paradigm.md` → 理解协作方式 ⭐
+3. **阅读项目日志**：`.claude/PROJECT_LOG.md` → 了解完整构建历史
+4. **加载增量记忆**：`.claude/MEMORY.md` → 获取最新变更
+5. **确认当前阶段**：`todo.md` → 了解待办任务
+
+**记忆加载优先级**：
+```
+ANCHORS.md → project-paradigm.md → PROJECT_LOG.md → MEMORY.md → 具体文件
+  (索引)         (协作范式)         (历史)      (变更)      (实现)
+```
+
+---
+
+## 📁 受保护目录（不可删除）
+
+以下目录包含核心基础设施，**严禁删除或清理**：
+
+| 目录 | 说明 |
+|------|------|
+| `prompts/` | Prompt 教学库（包含项目范式）⭐ |
+| `.claude/` | AI 自治记忆系统核心 ⭐ |
+| `.claude/thinking-routes/` | 思维轨迹系统 ⭐ |
+| `.claude/skills/` | 知识库 |
+| `.claude/hooks/` | 自动化钩子 |
+
+---
+
+## 项目信息
+
+- **项目名称**：[填写项目名称]
+- **技术栈**：[填写技术栈，如 React, TypeScript, Node.js]
+- **测试命令**：[如 npm test]
+- **构建命令**：[如 npm run build]
+
+---
+
+## 项目愿景
+
+[一句话描述项目的核心价值]
+
+---
+
+## 核心架构
+
+[简要描述项目的核心架构和设计理念]
+
+---
+
+## 代码风格
+
+遵循 **Linus Torvalds** 的编程哲学：
+
+### 1. 消除特殊情况
+- 通过优雅的数据结构让边界情况自然消失
+- 避免用 if/else 打补丁
+
+### 2. 极简主义
+- 函数只做一件事
+- 命名直白、精准
+
+### 3. 实用主义
+- 解决真实问题，拒绝过度设计
+
+### 质量指标
+- 单文件不超过 800 行
+- 单目录不超过 8 个文件
+- 零循环依赖
+- 零代码重复
+
+---
+
+## 关键规则
+
+[填写项目特定的关键规则和约束]
+
+---
+
+## 人类确认点
+
+AI 在以下情况必须暂停并请求人类确认：
+
+- 架构设计变更
+- 数据模型变更
+- 新增外部依赖
+- 质量标准定义
+- 安全与隐私相关变更
+
+---
+
+## 常用命令
+
+```bash
+# 开发
+npm run dev
+
+# 测试
+npm test
+
+# 构建
+npm run build
+
+# 类型检查
+npm run check
+```

package/template/README.md

@@ -0,0 +1,148 @@
+# Claude Code 项目模板
+
+> 通用 Claude Code 深度集成模板 - 适用于任何项目
+
+---
+
+## 快速开始
+
+```bash
+# 1. 复制整个模板文件夹到你的项目根目录
+cp -r claude-project-template/* /你的项目/
+
+# 2. 重命名 CLAUDE-template.md 为 CLAUDE.md
+mv /你的项目/.claude/CLAUDE-template.md /你的项目/.claude/CLAUDE.md
+
+# 3. 编辑 CLAUDE.md，填入你的项目信息
+vim /你的项目/.claude/CLAUDE.md
+
+# 4. 给 hooks 添加执行权限
+chmod +x /你的项目/.claude/hooks/*.js
+chmod +x /你的项目/.claude/hooks/*.sh
+
+# 5. 配置 Claude Code（如果还没配置）
+vim /你的项目/.claude/settings.json
+```
+
+---
+
+## 文件结构
+
+```
+claude-project-template/
+├── README.md                   # 本文件
+├── init.sh                     # 一键初始化脚本 ⭐
+├── project-paradigm.md         # 通用项目开发范式 ⭐
+├── CLAUDE-template.md          # CLAUDE.md 模板
+├── thinkinglens-silent.md      # 无感知追踪说明
+└── .claude/
+    ├── CLAUDE-template.md      # 项目 CLAUDE.md 模板
+    ├── settings.json           # Claude Code 配置模板
+    ├── hooks/
+    │   ├── thinking-silent.js  # 无感知对话追踪 Hook
+    │   ├── tl-summary.sh       # 查看对话摘要脚本
+    │   ├── sync-to-log.sh      # 同步对话到 PROJECT_LOG.md ⭐
+    │   └── session-end.sh      # 退出时保存摘要（可选）
+    └── thinking-routes/
+        └── QUICKREF.md         # 对话查找速查卡
+```
+
+---
+
+## 核心特性
+
+### 1. AI 自治记忆系统
+- **ANCHORS.md** - 锚点索引，快速定位模块
+- **MEMORY.md** - 增量记忆日志
+- **PROJECT_LOG.md** - 完整项目构建历史
+- **CLAUDE.md** - 项目核心知识
+
+### 2. 无感知追踪
+- **thinking-silent.js** - 零输出、自动追踪对话
+- **每 20 轮自动同步** - 对话摘要自动追加到 PROJECT_LOG.md ⭐
+- **tl-summary.sh** - 按需查看对话摘要
+- 数据本地存储，隐私安全
+
+### 3. 项目范式
+- **Personal Panopticon** - 个人全景塔理念
+- **锚点系统** - `[类型:名称]` 索引规范
+- **Skills 模板** - 领域知识库结构
+- **Hooks 配置** - 自动化钩子示例
+
+---
+
+## 配置说明
+
+### settings.json
+
+```json
+{
+  "matcher": "UserPromptSubmit|PreToolUse|PostToolUse",
+  "hooks": [{
+    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.js",
+    "timeout": 1
+  }]
+}
+```
+
+### CLAUDE.md 模板
+
+编辑以下部分：
+
+```markdown
+## Project Vision
+[你的项目愿景]
+
+## Stack
+[技术栈：React, TypeScript, Node.js...]
+
+## Common Commands
+[常用命令]
+```
+
+---
+
+## 使用命令
+
+```bash
+# 一键初始化（推荐）
+/path/to/claude-project-template/init.sh .
+
+# 查看对话摘要
+tl                    # 或 .claude/hooks/tl-summary.sh
+
+# 手动同步到日志
+.claude/hooks/sync-to-log.sh
+
+# 查看项目日志
+cat .claude/PROJECT_LOG.md
+
+# 查看记忆变更
+cat .claude/MEMORY.md
+```
+
+---
+
+## 成功标准
+
+完成后，项目应该具备：
+
+- ✅ AI 能够理解项目规范并生成符合标准的代码
+- ✅ AI 启动时自动加载完整上下文
+- ✅ 关键决策可追溯（ThinkingLens）
+- ✅ 知识可累积（Skills 系统）
+- ✅ 记忆可同步（Hooks）
+
+---
+
+## 更多文档
+
+- `project-paradigm.md` - 详细的开发范式说明
+- `thinkinglens-silent.md` - 无感知追踪原理
+- `.claude/thinking-routes/QUICKREF.md` - 对话查找速查
+
+---
+
+**记住**：目标不是让 AI 帮你写代码，而是让 AI 成为你思维的延伸。
+
+"Take the tower early. Do not let it take you."