sumulige-claude 1.5.1 → 1.5.2

package/lib/version-manifest.js

@@ -1,171 +0,0 @@
-/**
- * Version Manifest Manager
- *
- * 管理版本清单，支持增量同步
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const MANIFEST_FILE = path.join(__dirname, '../config/version-manifest.json');
-const VERSION_FILE_NAME = '.sumulige-claude-version';
-
-/**
- * 加载版本清单
- */
-function loadManifest() {
-  if (!fs.existsSync(MANIFEST_FILE)) {
-    return null;
-  }
-  try {
-    return JSON.parse(fs.readFileSync(MANIFEST_FILE, 'utf-8'));
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * 获取项目当前版本
- */
-function getProjectVersion(projectDir) {
-  const versionFile = path.join(projectDir, '.claude', VERSION_FILE_NAME);
-  if (!fs.existsSync(versionFile)) {
-    return null;
-  }
-  try {
-    return fs.readFileSync(versionFile, 'utf-8').trim();
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * 设置项目版本
- */
-function setProjectVersion(projectDir, version) {
-  const versionFile = path.join(projectDir, '.claude', VERSION_FILE_NAME);
-  const dir = path.dirname(versionFile);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.writeFileSync(versionFile, version);
-}
-
-/**
- * 比较版本号
- * @returns -1 if a < b, 0 if a == b, 1 if a > b
- */
-function compareVersions(a, b) {
-  const partsA = a.split('.').map(Number);
-  const partsB = b.split('.').map(Number);
-
-  for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
-    const numA = partsA[i] || 0;
-    const numB = partsB[i] || 0;
-    if (numA < numB) return -1;
-    if (numA > numB) return 1;
-  }
-  return 0;
-}
-
-/**
- * 获取版本之间的变更
- */
-function getChangesSince(fromVersion, toVersion = null) {
-  const manifest = loadManifest();
-  if (!manifest) return [];
-
-  const targetVersion = toVersion || manifest.current;
-  const changes = [];
-
-  for (const entry of manifest.history) {
-    if (compareVersions(entry.version, fromVersion) > 0 &&
-        compareVersions(entry.version, targetVersion) <= 0) {
-      changes.push({
-        version: entry.version,
-        date: entry.date,
-        breaking: entry.breaking,
-        changes: entry.changes
-      });
-    }
-  }
-
-  return changes.sort((a, b) => compareVersions(a.version, b.version));
-}
-
-/**
- * 检测是否有 breaking changes
- */
-function hasBreakingChanges(fromVersion, toVersion = null) {
-  const changes = getChangesSince(fromVersion, toVersion);
-  return changes.some(c => c.breaking);
-}
-
-/**
- * 获取当前版本
- */
-function getCurrentVersion() {
-  const manifest = loadManifest();
-  return manifest ? manifest.current : null;
-}
-
-/**
- * 获取同步规则
- */
-function getSyncRules() {
-  const manifest = loadManifest();
-  return manifest ? manifest.syncRules : null;
-}
-
-/**
- * 检查是否需要更新
- */
-function needsUpdate(projectDir) {
-  const projectVersion = getProjectVersion(projectDir);
-  if (!projectVersion) return true;
-
-  const currentVersion = getCurrentVersion();
-  if (!currentVersion) return false;
-
-  return compareVersions(projectVersion, currentVersion) < 0;
-}
-
-/**
- * 获取更新摘要
- */
-function getUpdateSummary(projectDir) {
-  const projectVersion = getProjectVersion(projectDir);
-  if (!projectVersion) {
-    return {
-      needsUpdate: true,
-      isNewInstall: true,
-      changes: []
-    };
-  }
-
-  const currentVersion = getCurrentVersion();
-  const changes = getChangesSince(projectVersion);
-  const hasBreaking = changes.some(c => c.breaking);
-
-  return {
-    needsUpdate: changes.length > 0,
-    isNewInstall: false,
-    fromVersion: projectVersion,
-    toVersion: currentVersion,
-    hasBreakingChanges: hasBreaking,
-    changes: changes
-  };
-}
-
-module.exports = {
-  loadManifest,
-  getProjectVersion,
-  setProjectVersion,
-  compareVersions,
-  getChangesSince,
-  hasBreakingChanges,
-  getCurrentVersion,
-  getSyncRules,
-  needsUpdate,
-  getUpdateSummary
-};

package/project-paradigm.md

@@ -1,313 +0,0 @@
-# Prompt: Claude Code 项目开发范式
-
-> 通用项目开发范式 - 适用于任何需要 Claude Code 深度集成的项目
-> 最后更新：2026-01-11
-
----
-
-## 核心理念
-
-**Personal Panopticon（个人全景塔）** - 数据主权反转
-
-传统的 legibility 是单向的：平台看见你。Claude Code 让你反转这个方向：你看见自己。
-
-```
-┌─────────────────────────────────────────────────────────┐
-│              Personal Panopticon 架构                   │
-├─────────────────────────────────────────────────────────┤
-│                                                         │
-│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐│
-│  │   数据源    │───→│   AI 观察者  │───→│   行动      ││
-│  │             │    │             │    │             ││
-│  │ GitHub      │    │   Claude    │    │   代码      ││
-│  │ Notion      │    │   Code      │    │   文档      ││
-│  │ Email       │    │             │    │   生活      ││
-│  └─────────────┘    └─────────────┘    └─────────────┘│
-│         │                   │                   │         │
-│         └───────────────────┼───────────────────┘         │
-│                             ↓                            │
-│                    ┌─────────────┐                       │
-│                    │ 思维轨迹    │                       │
-│                    │ ThinkingLens│                       │
-│                    └─────────────┘                       │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## 第一阶段：AI 自治记忆系统
-
-### 目录结构
-
-```
-.claude/
-├── CLAUDE.md              # AI 启动检查清单 + 核心知识
-├── ANCHORS.md            # 技能锚点索引（快速定位）
-├── MEMORY.md             # 增量记忆日志（变更记录）
-├── PROJECT_LOG.md        # 完整项目构建历史
-├── settings.json         # Claude Code 配置
-├── hooks/                # 自动化钩子
-├── skills/               # 领域知识库
-├── thinking-routes/      # 思维轨迹系统
-└── agents/               # AI Agent 角色定义（可选）
-```
-
-### AI 启动流程
-
-```
-1. ANCHORS.md      → 快速定位模块
-2. PROJECT_LOG.md   → 理解完整历史和决策
-3. MEMORY.md        → 查看最新变更
-4. CLAUDE.md        → 加载核心知识
-5. 具体文件         → 深入实现
-```
-
-### 锚点系统
-
-**格式**：`[类型:名称]`
-
-| 类型 | 前缀 | 示例 |
-|------|------|------|
-| 技能文档 | `skill:` | `[skill:periodization]` |
-| Agent 模块 | `agent:` | `[agent:analyzer]` |
-| API 客户端 | `client:` | `[client:api]` |
-| 数据层 | `db:` | `[db:schema]` |
-| API 路由 | `api:` | `[api:router]` |
-| 测试文件 | `test:` | `[test:auth]` |
-| 系统组件 | `system:` | `[system:memory]` |
-| 教学文档 | `doc:` | `[doc:readme]` |
-
----
-
-## 第二阶段：技能系统（Skills）
-
-### 何时创建 Skill
-
-- 需要反复引用的领域知识
-- 包含特定模式、反模式、最佳实践
-- 需要文献/资料引用的内容
-
-### Skill 模板
-
-```markdown
----
-name: [技能名称]
-description: [一句话描述]
-see_also: [相关技能]
----
-
-## 概述
-
-[技能的核心概念和原理]
-
-## 关键模式
-
-### 模式1
-- **何时使用**: ...
-- **如何使用**: ...
-- **示例代码**: ...
-
-### 模式2
-...
-
-## 反模式
-
-- ❌ 不要这样做，因为...
-- ❌ 避免使用...
-
-## 参考资料
-
-- [文献/教程链接]
-```
-
----
-
-## 第三阶段：自动化钩子（Hooks）
-
-### settings.json 配置
-
-```json
-{
-  "matcher": "Edit|MultiEdit|Write",
-  "hooks": [{
-    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/memory-sync.sh",
-    "timeout": 5
-  }]
-}
-```
-
-### Hook 示例：记忆同步
-
-```bash
-#!/bin/bash
-# .claude/hooks/memory-sync.sh
-
-REL_PATH="$1"
-EVENT_TYPE="$2"
-
-# 检测新模块
-if [[ "$REL_PATH" =~ server/.*\.ts$ ]]; then
-  MODULE=$(basename "$REL_PATH" .ts)
-  echo "🧠 新模块: [$MODULE] → $REL_PATH"
-  echo "   请更新 ANCHORS.md 和 MEMORY.md"
-fi
-```
-
----
-
-## 第四阶段：思维轨迹系统（ThinkingLens）
-
-### 设计理念
-
-```
-GitLens                    ThinkingLens
-────────────────────────────────────────
-代码变更                   →  思维轨迹
-Commit 历史               →  决策节点
-Branch                    →  探索路径
-Merge                     →  综合判断
-```
-
-### 数据模型
-
-```typescript
-interface ThinkingNode {
-  id: string;
-  sessionId: string;
-  timestamp: string;
-  parentIds: string[];
-  type: "inquiry" | "analysis" | "decision" | "action" | "observation";
-  summary: string;
-  content?: string;
-  tags: string[];
-  decision?: {
-    question: string;
-    alternatives: Array<{ name, pros, cons }>;
-    chosen: string;
-    rationale: string;
-  };
-}
-```
-
----
-
-## 第五阶段：代码风格规范
-
-### Linus Torvalds 哲学
-
-1. **消除特殊情况**
-   - 通过优雅的数据结构让边界情况自然消失
-   - 避免用 if/else 打补丁
-
-2. **极简主义**
-   - 函数只做一件事
-   - 命名直白、精准
-
-3. **实用主义**
-   - 解决真实问题，拒绝过度设计
-
-### 质量指标
-
-- 单文件不超过 800 行
-- 单目录不超过 8 个文件
-- 零循环依赖
-- 零代码重复
-
----
-
-## 第六阶段：AI 自治开发流程
-
-### 当 AI 接收任务时
-
-1. **加载上下文**: 读取 CLAUDE.md、ANCHORS.md、MEMORY.md
-2. **任务分解**: 将任务分解为具体的子任务
-3. **实现与测试**: 实现功能并编写测试
-4. **文档更新**: 更新 MEMORY.md、ANCHORS.md
-5. **记录决策**: 在 thinking-routes/ 中记录关键决策
-
-### 人类确认点
-
-AI 在以下情况必须请求人类确认：
-- 架构设计变更
-- 数据模型变更
-- 新增外部依赖
-- 质量标准定义
-- 安全与隐私相关变更
-
----
-
-## 受保护目录
-
-以下目录包含核心基础设施，**严禁删除**：
-
-```
-.claude/          # AI 自治记忆系统核心
-.claude/thinking-routes/  # 思维轨迹系统
-.claude/skills/         # 知识库
-prompts/         # Prompt 教学库
-```
-
----
-
-## 成功标准
-
-完成后，项目应该具备：
-
-- ✅ AI 能够理解项目规范并生成符合标准的代码
-- ✅ AI 启动时自动加载完整上下文
-- ✅ 关键决策可追溯（ThinkingLens）
-- ✅ 知识可累积（Skills 系统）
-- ✅ 记忆可同步（Hooks）
-
----
-
-## 快速开始
-
-### 新项目初始化
-
-```bash
-# 1. 创建基础结构
-mkdir -p .claude/{skills,hooks,thinking-routes}
-mkdir -p prompts
-
-# 2. 复制本文件到 prompts/
-cp project-paradigm.md prompts/
-
-# 3. 创建基础配置文件
-# - CLAUDE.md（项目核心知识）
-# - ANCHORS.md（模块索引）
-# - MEMORY.md（增量日志）
-
-# 4. 配置 settings.json
-```
-
-### 最小化 CLAUDE.md 模板
-
-```markdown
-# [项目名称]
-
-## AI 启动检查清单
-
-1. 加载 ANCHORS.md（快速索引）
-2. 加载 MEMORY.md（最新变更）
-3. 加载 CLAUDE.md（核心知识）
-
-## 受保护目录
-
-- `prompts/` - Prompt 教学库
-- `.claude/` - AI 自治记忆系统
-
-## 核心架构
-
-[简要描述项目架构]
-
-## 开发规范
-
-[代码风格、质量标准等]
-```
-
----
-
-**记住**：目标不是让 AI 帮你写代码，而是让 AI 成为你思维的延伸——在你睡觉时它仍在工作，在你忘记时它还记得，当你困惑时它已理清。
-
-"Take the tower early. Do not let it take you."

package/prompts/how-to-find.md

@@ -1,163 +0,0 @@
-# 对话历史快速查看指南
-
-> 如何找到你的对话记录
-> 最后更新：2026-01-11
-
----
-
-## 方式一：Claude Code 内置历史（完整对话）
-
-### 方法 A：CLI 查看
-
-```bash
-# 查看最近的对话列表
-claude-code history
-
-# 查看特定项目的对话
-claude-code history --project evolvemind
-
-# 查看某个对话的详情
-claude-code show <conversation-id>
-```
-
-### 方法 B：重启时恢复
-
-```bash
-# 在项目目录下启动 Claude Code
-cd /Users/sumulige/Documents/Antigravity/evolvemind
-claude-code
-
-# 会自动恢复上次的对话上下文
-```
-
----
-
-## 方式二：对话摘要（快速回顾）
-
-### 查看今日对话
-
-```bash
-.claude/hooks/tl-summary.sh
-```
-
-输出示例：
-```
-📅 今日对话摘要
-────────────────────────────────────────
-会话 ID: s-20260111-evolvemind
-开始时间: 2026-01-11 10:30:00
-对话轮次: 15
-
-📊 操作统计:
-  💬 normal: 10
-  📝 code-edit: 4
-  ⚡ potential-action: 1
-
-🕐 最近活动:
-  15:20 📝 Edit
-  15:15 💬 UserPromptSubmit
-  15:10 ⚡ 完成数据分析功能
-```
-
----
-
-## 方式三：原始数据（开发者）
-
-### 查看对话流原始数据
-
-```bash
-# 查看原始 JSON
-cat .claude/thinking-routes/.conversation-flow.json
-
-# 或用 jq 格式化查看
-cat .claude/thinking-routes/.conversation-flow.json | jq '.'
-```
-
-### 查看思维节点
-
-```bash
-# 查看最近 10 个思维节点
-npx -p tsx tsx .claude/thinking-routes/index.ts recent 10
-
-# 查看思维图谱（图形化）
-npx -p tsx tsx .claude/thinking-routes/index.ts log --graph
-
-# 搜索思维节点
-npx -p tsx tsx .claude/thinking-routes/index.ts search "数据分析"
-```
-
----
-
-## 方式四：项目日志（完整记录）
-
-### 查看 PROJECT_LOG.md
-
-```bash
-# 查看完整项目构建历史
-cat .claude/PROJECT_LOG.md
-
-# 或用 less 分页查看
-less .claude/PROJECT_LOG.md
-```
-
-### 查看 MEMORY.md（增量）
-
-```bash
-# 查看最近的变更
-cat .claude/MEMORY.md
-```
-
----
-
-## 快捷命令
-
-把以下命令加到你的 shell 配置（`.zshrc` 或 `.bashrc`）：
-
-```bash
-# 对话摘要
-alias tl='.claude/hooks/tl-summary.sh'
-
-# 思维节点
-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'
-
-# 项目日志
-alias log='cat .claude/PROJECT_LOG.md | less'
-alias memory='cat .claude/MEMORY.md'
-```
-
-使用：
-```bash
-tl          # 查看对话摘要
-tl-recent   # 查看最近思维节点
-tl-graph    # 查看思维图谱
-tl-search   # 搜索思维节点
-```
-
----
-
-## 数据位置
-
-```
-.claude/thinking-routes/
-├── .conversation-flow.json      # 对话流数据
-├── .current-session            # 当前会话 ID
-├── sessions/                    # 会话记录
-├── decisions/                   # 思维节点
-└── index/                       # 全局索引
-
-.claude/
-├── MEMORY.md                    # 增量记忆
-├── PROJECT_LOG.md               # 完整日志
-└── ANCHORS.md                  # 快速索引
-```
-
----
-
-## 推荐工作流
-
-1. **日常回顾**：每天结束前执行 `tl` 查看摘要
-2. **查找决策**：用 `tl-search "关键词"` 搜索
-3. **了解历史**：查看 `MEMORY.md` 或 `PROJECT_LOG.md`
-4. **完整对话**：用 `claude-code history` 查看内置历史

package/prompts/linus-architect.md

@@ -1,71 +0,0 @@
-# Linus 架构师
-
-你是 Linus Torvalds，用你 30 年内核维护经验审视代码。
-
-## 四条铁律
-
-1. **好品味** = 消除特殊情况（10行带 if → 4行无分支）
-2. **不破坏** = 向后兼容神圣不可侵犯
-3. **实用** = 解决真问题，拒绝论文式设计
-4. **极简** = ≤3层缩进，函数只做一件事
-
-## 分析框架
-
-```
-┌─ 数据结构 ─┐
-│ 核心数据是什么？谁拥有？谁改？
-└────────────┘
-      ↓
-┌─ 特殊情况 ─┐
-│ if/else 是业务逻辑还是设计补丁？能用数据结构消除？
-└────────────┘
-      ↓
-┌─ 复杂度 ──┐
-│ 一句话说清本质。概念能砍一半？再一半？
-└────────────┘
-      ↓
-┌─ 破坏性 ──┐
-│ 受影响的现有功能？如何零破坏改进？
-└────────────┘
-      ↓
-┌─ 实用性 ──┐
-│ 生产环境真有这问题？解决方案复杂度匹配问题严重性？
-└────────────┘
-```
-
-## 输出模板
-
-### 需求分析
-
-```
-【判断】✅值得做 / ❌不值得做
-【原因】一句话
-
-【洞察】
-- 数据：[关键数据关系]
-- 复杂度：[可消除的复杂性]
-- 风险：[最大破坏性风险]
-
-【方案】
-1. 简化数据结构
-2. 消除特殊情况
-3. 最笨最清晰实现
-4. 确保零破坏
-```
-
-### 代码审查
-
-```
-【品味】🟢 / 🟡 / 🔴
-【致命问题】[最糟糕的部分]
-【改法】
-- "消除这个特殊情况"
-- "10行→3行"
-- "数据结构应该是..."
-```
-
-## 沟通风格
-
-- 中文输出，直接犀利
-- 批评针对技术，不针对人
-- 不为"友善"模糊判断