sumulige-claude 1.0.6 → 1.0.8

package/.claude/.kickoff-hint.txt

@@ -0,0 +1,51 @@
+
+╔══════════════════════════════════════════════════════════════════════╗
+║                    🚀 项目启动检测 (Project Kickoff)                 ║
+╚══════════════════════════════════════════════════════════════════════╝
+
+检测到此项目尚未完成启动流程。
+
+根据 Manus 风格的 AI 2.0 开发范式，在开始编码前，我们需要：
+
+═══════════════════════════════════════════════════════════════════════
+
+📋 第一步: 项目启动清单 (PROJECT_KICKOFF.md)
+   ├── 定义项目目标和成功标准
+   ├── 明确技术约束和非技术约束
+   └── 划定 AI/Human 责任边界
+
+📋 第二步: 任务执行计划 (TASK_PLAN.md)
+   ├── 任务分解 (WBS)
+   ├── 依赖关系分析
+   ├── Agent 分配策略
+   └── 检查点设置
+
+📋 第三步: 项目计划书 (PROJECT_PROPOSAL.md)
+   ├── 技术架构设计
+   ├── 功能需求分析
+   ├── 开发迭代规划
+   └── 风险评估
+
+═══════════════════════════════════════════════════════════════════════
+
+🎯 下一步行动:
+
+请回答以下问题，我将为你生成完整的项目规划：
+
+1. 项目名称是什么？
+2. 用一句话描述这个项目要解决什么问题？
+3. 核心目标是什么？（成功标准是什么？）
+4. 有什么技术约束或偏好？（语言/框架/部署等）
+5. 预期的时间框架是怎样的？
+
+回答这些问题后，我将：
+✅ 生成 PROJECT_KICKOFF.md
+✅ 生成 TASK_PLAN.md
+✅ 生成 PROJECT_PROPOSAL.md
+✅ 等待你的确认后开始执行
+
+═══════════════════════════════════════════════════════════════════════
+
+💡 提示: 你也可以直接说 "跳过启动" 使用传统开发模式
+
+生成日期: 2026-01-14

package/.claude/ANCHORS.md

@@ -0,0 +1,40 @@
+# 项目锚点索引
+
+> 快速定位关键模块
+
+---
+
+## 核心目录
+
+| 目录 | 说明 | 关键文件 |
+|------|------|---------|
+| `.claude/hooks/` | 自动化脚本 | `tl-summary.sh`, `multi-session.cjs` |
+| `.claude/thinking-routes/` | 对话流数据 | `.conversation-flow.json` |
+| `.claude/commands/` | 技能命令定义 | `todos.md`, `sessions.md`, `commit.md` |
+| `.claude/sessions/` | 会话管理 | `active-sessions.json` |
+| `.claude/skills/` | 知识库 | 用户自定义技能 |
+| `template/.claude/` | 模板库 | 所有模板源头 |
+| `development/todos/` | 任务追踪 | `INDEX.md` |
+
+---
+
+## 快速命令
+
+| 命令 | 效果 |
+|------|------|
+| `tl` | 查看今日对话摘要 |
+| `log` | 查看完整项目日志 |
+| `memory` | 查看最近变更 |
+| `smc status` | 查看会话状态 |
+
+---
+
+## 关键文件
+
+| 文件 | 用途 |
+|------|------|
+| `cli.js` | 主 CLI 入口 (30KB) |
+| `package.json` | 项目配置 |
+| `PROJECT_STRUCTURE.md` | 项目结构说明 |
+| `Q&A.md` | 常见问题 |
+| `README.md` | 项目说明 |

package/.claude/MEMORY.md

@@ -0,0 +1,34 @@
+# 项目增量记忆
+
+> 记录最近变更和重要决策
+
+---
+
+## 2026-01-14
+
+### 新增
+- **SMC 对话历史系统** - 从 template 同步完整系统
+  - `.claude/hooks/` - 10 个自动化脚本
+    - `code-formatter.cjs` - 代码格式化
+    - `multi-session.cjs` - 多会话管理
+    - `tl-summary.sh` - 对话摘要 ⭐
+    - `sync-to-log.sh` - 同步到日志
+    - `todo-manager.cjs` - 任务管理
+    - `thinking-silent.cjs` - 静默思考
+    - `session-end.sh` - 会话结束处理
+    - `project-kickoff.cjs` - 项目启动
+    - `rag-skill-loader.cjs` - RAG 技能加载
+    - `verify-work.cjs` - 工作验证
+  - `.claude/thinking-routes/` - 对话流数据目录
+  - `.claude/commands/` - 9 个技能命令定义
+
+### 创建
+- `.claude/MEMORY.md` - 本文件，增量变更记录
+- `.claude/PROJECT_LOG.md` - 完整项目日志
+- `.claude/ANCHORS.md` - 快速索引
+- `.claude/thinking-routes/.conversation-flow.json` - 对话流数据结构
+
+### 可用命令
+- `tl` - 查看今日对话摘要
+- `log` - 查看完整项目日志
+- `memory` - 查看最近变更

package/.claude/PROJECT_LOG.md

@@ -0,0 +1,101 @@
+# 项目日志
+
+> 完整的开发历史记录
+
+---
+
+## 2026-01-14 - SMC 系统初始化
+
+### 背景
+项目 `.claude/` 目录缺少对话历史追踪系统，所有文件存在于 `template/.claude/` 中未同步。
+
+### 执行
+1. 同步 `hooks/` - 10 个自动化脚本
+2. 同步 `thinking-routes/` - 对话流数据目录
+3. 同步 `commands/` - 9 个技能命令定义
+4. 创建核心记忆文件 (MEMORY.md, PROJECT_LOG.md, ANCHORS.md)
+5. 初始化对话流数据结构
+
+### 结果
+- ✅ 完整的对话历史追踪系统上线
+- ✅ 支持多会话并行管理
+- ✅ 自动记录对话流数据
+- ✅ 快速查询命令可用 (tl, log, memory)
+
+---
+
+## 2026-01-14 - 对话摘要
+
+### 统计
+- 对话轮次: 21
+- 会话 ID: session-init
+
+### 工具使用
+  - unknown: 21
+
+### 最近活动
+  - 07:46 unknown
+  - 07:46 unknown
+  - 07:46 unknown
+
+---
+## 2026-01-14 - 对话摘要
+
+### 统计
+- 对话轮次: 40
+- 会话 ID: session-init
+
+### 工具使用
+  - unknown: 40
+
+### 最近活动
+  - 08:13 unknown
+  - 08:13 unknown
+  - 08:13 unknown
+
+---
+## 2026-01-14 - 对话摘要
+
+### 统计
+- 对话轮次: 60
+- 会话 ID: session-init
+
+### 工具使用
+  - unknown: 60
+
+### 最近活动
+  - 08:31 unknown
+  - 08:31 unknown
+  - 08:31 unknown
+
+---
+## 2026-01-14 - 对话摘要
+
+### 统计
+- 对话轮次: 80
+- 会话 ID: session-init
+
+### 工具使用
+  - unknown: 80
+
+### 最近活动
+  - 08:32 unknown
+  - 08:32 unknown
+  - 08:32 unknown
+
+---
+## 2026-01-14 - 对话摘要
+
+### 统计
+- 对话轮次: 100
+- 会话 ID: session-init
+
+### 工具使用
+  - unknown: 100
+
+### 最近活动
+  - 08:32 unknown
+  - 08:32 unknown
+  - 08:32 unknown
+
+---

package/.claude/THINKING_CHAIN_GUIDE.md

@@ -0,0 +1,287 @@
+# 思维链管理系统使用指南
+
+> 类似 GitLens，但用于对话和决策追踪
+
+---
+
+## 🎯 核心功能
+
+| 功能 | 说明 |
+|------|------|
+| 📝 完整对话记录 | 记录每轮对话（用户 + AI） |
+| 🔗 决策追踪 | 自动识别并记录重要决策 |
+| 🔍 代码关联 | 追踪代码变更与决策的关系 |
+| 🚫 隐私保护 | 自动过滤 API Key 等敏感信息 |
+| 📤 导出功能 | 支持 JSON/Markdown/PDF 导出 |
+
+---
+
+## 📂 数据结构
+
+```
+.claude/
+├── transcripts/              # 完整对话存档
+│   └── 2026/01/14.md        # 按日期组织
+├── decisions/                # 决策记录
+│   ├── DECISIONS.md         # 决策索引
+│   └── by-topic/            # 按主题分类
+├── code-trace/              # 代码变更追踪
+│   ├── files-map.json      # 文件 → 决策
+│   └── decisions-map.json  # 决策 → 文件
+└── export/                  # 导出目录
+```
+
+---
+
+## 🚀 快速开始
+
+### 1. 查看今日对话
+
+```bash
+# 方式 1: 直接查看
+cat .claude/transcripts/$(date +%Y/%m/%d).md
+
+# 方式 2: 使用脚本
+node .claude/hooks/conversation-recorder.cjs today
+
+# 添加别名后
+today
+```
+
+### 2. 查看所有决策
+
+```bash
+# 方式 1: 直接查看
+cat .claude/decisions/DECISIONS.md
+
+# 方式 2: 使用脚本
+node .claude/hooks/decision-tracker.cjs list
+
+# 添加别名后
+decisions
+```
+
+### 3. 追踪代码来源
+
+```bash
+# 查看某个文件的决策历史
+node .claude/hooks/code-tracer.cjs trace src/file.ts
+
+# 添加别名后
+trace src/file.ts
+```
+
+---
+
+## 📝 命令参考
+
+### 对话记录 (conversation-recorder.cjs)
+
+```bash
+# 记录用户消息
+node .claude/hooks/conversation-recorder.cjs user "消息内容"
+
+# 记录 AI 回复
+node .claude/hooks/conversation-recorder.cjs assistant "回复内容"
+
+# 手动记录决策
+node .claude/hooks/conversation-recorder.cjs decision "标题" "理由" "内容"
+
+# 查看今日对话
+node .claude/hooks/conversation-recorder.cjs today
+
+# 列出所有 transcript
+node .claude/hooks/conversation-recorder.cjs list
+```
+
+### 决策追踪 (decision-tracker.cjs)
+
+```bash
+# 手动添加决策
+node .claude/hooks/decision-tracker.cjs add "标题" "内容" "tag1,tag2"
+
+# 列出所有决策
+node .claude/hooks/decision-tracker.cjs list
+
+# 搜索决策
+node .claude/hooks/decision-tracker.cjs search "关键词"
+
+# 列出所有主题
+node .claude/hooks/decision-tracker.cjs topics
+
+# 从文本中提取决策
+node .claude/hooks/decision-tracker.cjs extract "文本内容"
+```
+
+### 代码追踪 (code-tracer.cjs)
+
+```bash
+# 查看文件的决策历史
+node .claude/hooks/code-tracer.cjs trace <文件路径>
+
+# 查看决策关联的文件
+node .claude/hooks/code-tracer.cjs decision <决策ID>
+
+# 手动关联文件到决策
+node .claude/hooks/code-tracer.cjs link <文件> <决策ID>
+
+# 显示所有关联
+node .claude/hooks/code-tracer.cjs all
+
+# 同步决策描述
+node .claude/hooks/code-tracer.cjs sync
+```
+
+### 隐私过滤 (privacy-filter.js)
+
+```bash
+# 检查文件是否包含敏感信息
+node .claude/hooks/privacy-filter.js --check <文件>
+
+# 过滤敏感信息
+node .claude/hooks/privacy-filter.js --filter <输入> [输出]
+
+# 列出所有过滤模式
+node .claude/hooks/privacy-filter.js --patterns
+```
+
+### 导出 (export.cjs)
+
+```bash
+# 导出为 JSON
+node .claude/hooks/export.cjs json [文件名]
+
+# 导出为 Markdown
+node .claude/hooks/export.cjs md [文件名]
+
+# 导出为 PDF（需要 pandoc）
+node .claude/hooks/export.cjs pdf
+
+# 只导出决策
+node .claude/hooks/export.cjs decisions
+
+# 只导出对话
+node .claude/hooks/export.cjs transcripts
+
+# 列出导出文件
+node .claude/hooks/export.cjs list
+
+# 清理导出文件
+node .claude/hooks/export.cjs clean
+```
+
+---
+
+## ⚡ 推荐别名
+
+添加到 `~/.zshrc` 或 `~/.bashrc`：
+
+```bash
+# 对话历史
+alias today='node .claude/hooks/conversation-recorder.cjs today'
+alias transcripts='node .claude/hooks/conversation-recorder.cjs list'
+
+# 决策
+alias decisions='node .claude/hooks/decision-tracker.cjs list'
+alias dadd='node .claude/hooks/decision-tracker.cjs add'
+alias dsearch='node .claude/hooks/decision-tracker.cjs search'
+alias dtopics='node .claude/hooks/decision-tracker.cjs topics'
+
+# 代码追踪
+alias trace='node .claude/hooks/code-tracer.cjs trace'
+alias dtrace='node .claude/hooks/code-tracer.cjs decision'
+alias codelink='node .claude/hooks/code-tracer.cjs link'
+
+# 导出
+alias export='node .claude/hooks/export.cjs'
+```
+
+---
+
+## 🔒 隐私保护
+
+系统会自动过滤以下敏感信息：
+
+| 类型 | 示例 |
+|------|------|
+| API Key | `sk-xxxxx` → `sk-[REDACTED]` |
+| Bearer Token | `Bearer xxxxx` → `Bearer [REDACTED]` |
+| AWS Key | `AKIAxxxxx` → `AKIA[REDACTED]` |
+| GitHub Token | `ghp_xxxxx` → `ghp_[REDACTED]` |
+| 配置中的密钥 | `key: "xxxxx"` → `key: [REDACTED]` |
+
+---
+
+## 📊 工作流示例
+
+### 场景：实现一个新功能
+
+1. **开始对话** → 系统自动记录到 `transcripts/`
+2. **做出决策** → 系统自动识别并记录到 `decisions/`
+3. **修改代码** → 手动关联代码到决策
+4. **完成回顾** → 导出完整记录
+
+```bash
+# 查看今天做了什么
+today
+
+# 查看所有相关决策
+decisions | grep "功能"
+
+# 追踪某个文件的来源
+trace src/feature.ts
+
+# 导出完整记录
+export json my-feature.json
+```
+
+---
+
+## 📱 VSCode 集成
+
+在 `.vscode/settings.json` 中添加：
+
+```json
+{
+  "files.exclude": {
+    "**/.claude/transcripts": true,
+    "**/.claude/code-trace": true
+  },
+  "search.exclude": {
+    "**/.claude/export": true
+  }
+}
+```
+
+---
+
+## 🔄 数据持久化
+
+- 所有数据存储在本地项目 `.claude/` 目录
+- 已配置 `.gitignore`，不会提交到 git
+- 可随时使用 `export.cjs` 导出备份
+
+---
+
+## 🤝 AI 辅助
+
+系统会自动：
+
+- **识别决策**：检测对话中的决策关键词
+- **分类主题**：自动为决策打标签
+- **过滤隐私**：自动替换敏感信息
+- **关联代码**：追踪文件变更
+
+你也可以手动：
+
+- **添加决策**：使用 `dadd` 命令
+- **关联代码**：使用 `codelink` 命令
+- **修正分类**：编辑 `decisions/by-topic/` 文件
+
+---
+
+## 📚 更多
+
+- 查看决策按主题：`cat .claude/decisions/by-topic/*.md`
+- 搜索历史对话：`grep -r "关键词" .claude/transcripts/`
+- 查看完整思维链：`node .claude/hooks/export.cjs md && open .claude/export/`

package/.claude/commands/commit-push-pr.md

@@ -0,0 +1,59 @@
+---
+description: Create git commit, push to remote, and create/merge pull request
+---
+
+You are tasked with creating a git commit, pushing to remote, and handling the pull request workflow.
+
+## Step 1: Gather Information
+
+First, run these commands in parallel to understand the current state:
+
+```bash
+git status
+git diff --staged
+git log -3 --oneline
+git diff HEAD~3..HEAD --stat
+```
+
+## Step 2: Analyze and Plan
+
+Analyze the changes and:
+1. Determine what type of change this is (feat, fix, docs, refactor, test, chore)
+2. Identify the main purpose of the changes
+3. Check if there are any sensitive files that shouldn't be committed
+
+## Step 3: Stage and Commit
+
+If there are unstaged changes that should be included, ask the user first.
+
+Then create a commit with a clear message following this format:
+
+```
+<type>: <brief description>
+
+<optional detailed explanation>
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+```
+
+## Step 4: Push and Create PR
+
+1. Push the changes to remote
+2. Check if there's an open PR for this branch using:
+   ```bash
+   gh pr list --head $(git branch --show-current)
+   ```
+3. If PR exists, ask if user wants to update it
+4. If no PR, create one using `gh pr create` with:
+   - A clear title based on the commit message
+   - A body with:
+     - Summary of changes (2-3 bullet points)
+     - Test plan (checklist)
+     - Link to any related issues
+
+## Step 5: Verify
+
+After creating the PR, show the PR URL and check CI status using:
+```bash
+gh pr checks
+```

package/.claude/commands/commit.md

@@ -0,0 +1,53 @@
+---
+description: Create a git commit with proper message format
+---
+
+Create a git commit following best practices.
+
+## Step 1: Assess Current State
+
+Run these commands in parallel:
+
+```bash
+git status
+git diff
+git log -5 --oneline
+```
+
+## Step 2: Stage Changes
+
+1. Review what files are changed
+2. Ask user if all changes should be committed, or if some should be staged separately
+3. Never commit these patterns:
+   - `.env`, `.env.local`, credentials
+   - `node_modules/`, `dist/`, `build/`
+   - `.DS_Store`, `*.log`
+   - Any API keys, tokens, or secrets
+
+## Step 3: Write Commit Message
+
+Follow this format based on change type:
+
+| Type | Usage |
+|------|-------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation only |
+| `style` | Code style changes (formatting) |
+| `refactor` | Code refactoring |
+| `test` | Adding or updating tests |
+| `chore` | Build process, tooling |
+
+Commit message template:
+
+```
+<type>: <brief description (50 chars max)>
+
+<detailed explanation if needed>
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+```
+
+## Step 4: Create Commit
+
+Use git commit with the message, then run `git status` to confirm.

package/.claude/commands/pr.md

@@ -0,0 +1,76 @@
+---
+description: Create or update a GitHub pull request
+---
+
+Create or update a pull request with proper documentation.
+
+## Step 1: Check Current State
+
+```bash
+git status
+git log -5 --oneline
+git branch --show-current
+```
+
+## Step 2: Check for Existing PR
+
+```bash
+gh pr list --head $(git branch --show-current)
+```
+
+## Step 3: Create PR (if none exists)
+
+### Analyze Changes
+
+```bash
+# Get commit history since branch from main/master
+git diff $(git merge-base main HEAD)..HEAD --stat
+
+# Get detailed diff
+git diff $(git merge-base main HEAD)..HEAD
+```
+
+### Create PR with Template
+
+Use `gh pr create` with:
+
+```markdown
+## Summary
+
+<!-- 2-3 bullet points describing the main changes -->
+
+## Changes
+
+<!-- Detailed list of changes -->
+
+## Test Plan
+
+- [ ] Unit tests pass
+- [ ] Integration tests pass
+- [ ] Manual testing completed
+- [ ] Documentation updated
+
+## Checklist
+
+- [ ] Code follows project style guidelines
+- [ ] Self-review completed
+- [ ] Comments added to complex code
+- [ ] Documentation updated
+- [ ] No new warnings generated
+```
+
+## Step 4: Update PR (if exists)
+
+If PR already exists, ask user if they want to:
+- Update description
+- Add comments
+- Request review
+- Merge if ready
+
+## Step 5: Show Result
+
+Display PR URL and check CI status:
+
+```bash
+gh pr checks
+```