sumulige-claude 1.5.1 → 1.5.2

package/DEV_TOOLS_GUIDE.md

@@ -1,190 +0,0 @@
-# 🛠️ 开发工具速查手册
-
-> 写给高中生的通俗指南 - 每个工具一句话解释 + 常用命令
-
----
-
-## 📋 工具一览表
-
-| 工具 | 一句话解释 | 类比 |
-|------|-----------|------|
-| **zellij** | 终端分屏器 | 像把一个窗口分成多个小窗口 |
-| **fnm** | Node.js 版本管理 | 像手机可以装多个微信 |
-| **pyenv** | Python 版本管理 | 同时装多个 Python 版本 |
-| **uv** | Python 包安装器 | pip 的超快替代品 |
-| **pgcli** | 数据库命令行 | 带自动补全的 PostgreSQL 客户端 |
-| **bat** | 更好看的查看文件 | cat 命令的美化版 |
-| **eza** | 更好看的文件列表 | ls 命令的美化版 |
-| **fzf** | 模糊搜索 | Ctrl+R 搜历史命令 |
-| **lazygit** | Git 图形界面 | 在终端里用图形化操作 Git |
-
----
-
-## 🎯 分屏神器 - Zellij
-
-**干啥用**：把一个终端窗口分成多个区域，同时运行多个命令
-
-**启动**：
-```bash
-zellij      # 启动
-zj          # 快捷别名
-```
-
-**常用操作**：
-| 按键 | 作用 |
-|------|------|
-| `Ctrl+p` 然后 `n` | 新建标签页 |
-| `Ctrl+p` 然后 `d` | 垂直分屏 |
-| `Ctrl+p` 然后 `r` | 水平分屏 |
-| `Ctrl+p` 然后 `x` | 关闭当前面板 |
-| `Ctrl+p` 然后 `w` | 切换面板 |
-
-**使用场景**：
-- 一边写代码，一边看日志
-- 同时运行前端和后端服务器
-
----
-
-## 📦 Node 版本管理 - fnm
-
-**干啥用**：不同项目可能需要不同版本的 Node.js，fnm 帮你切换
-
-**常用命令**：
-```bash
-fnm list-remote     # 看有哪些版本可以装
-fnm install 20      # 安装 Node 20
-fnm install 22      # 安装 Node 22
-fnm use 20          # 切换到 Node 20
-fnm default 22      # 设置默认版本
-fnm current         # 查看当前版本
-```
-
-**使用场景**：
-- 老项目需要 Node 18，新项目需要 Node 22
-- 进入项目文件夹自动切换版本（如果有 .node-version 文件）
-
----
-
-## 🐍 Python 版本管理 - pyenv
-
-**干啥用**：管理多个 Python 版本
-
-**常用命令**：
-```bash
-pyenv install --list    # 看有哪些版本
-pyenv install 3.12.0    # 安装 Python 3.12
-pyenv global 3.12.0     # 设置全局默认
-pyenv local 3.11.0      # 当前目录用 3.11
-pyenv versions          # 查看已安装版本
-```
-
----
-
-## ⚡ 超快包管理 - uv
-
-**干啥用**：替代 pip，安装 Python 包快 10-100 倍
-
-**常用命令**：
-```bash
-uv pip install pandas      # 安装包
-uv pip install -r req.txt  # 从文件安装
-uv venv                    # 创建虚拟环境
-uv run python script.py    # 运行脚本
-```
-
-**对比**：
-| 命令 | pip 用时 | uv 用时 |
-|------|---------|---------|
-| 安装 pandas | 30 秒 | 2 秒 |
-| 创建环境 | 5 秒 | 0.5 秒 |
-
----
-
-## 🐘 数据库工具 - pgcli
-
-**干啥用**：连接 PostgreSQL 数据库，带自动补全
-
-**使用**：
-```bash
-pgcli -h localhost -u postgres -d mydb
-# 或
-pgcli postgres://user:pass@host/db
-```
-
-**特点**：
-- 自动补全表名、列名
-- 语法高亮
-- 历史命令搜索
-
----
-
-## 👀 更好看的命令 - bat & eza
-
-**bat** - 替代 cat：
-```bash
-bat README.md       # 带语法高亮看文件
-bat -A file.txt     # 显示隐藏字符
-```
-
-**eza** - 替代 ls：
-```bash
-ls          # 已经是 eza 的别名
-ll          # 详细列表 + 图标
-lt          # 树形目录
-```
-
----
-
-## 🔍 模糊搜索 - fzf
-
-**干啥用**：快速搜索文件、命令历史
-
-**使用**：
-```bash
-Ctrl+R      # 搜索历史命令
-Ctrl+T      # 搜索文件
-```
-
----
-
-## 🌳 Git 图形化 - lazygit
-
-**干啥用**：在终端用图形界面操作 Git
-
-**启动**：
-```bash
-lg          # 快捷别名
-lazygit     # 完整命令
-```
-
-**常用操作**：
-| 按键 | 作用 |
-|------|------|
-| `space` | 暂存/取消暂存文件 |
-| `c` | 提交 |
-| `p` | 推送 |
-| `P` | 拉取 |
-| `b` | 查看分支 |
-| `q` | 退出 |
-
----
-
-## 🎨 快捷别名总结
-
-```bash
-# 你现在可以用的快捷命令
-ls   → eza（带图标的文件列表）
-ll   → 详细列表
-lt   → 树形目录
-cat  → bat（带高亮的查看）
-lg   → lazygit（Git 图形界面）
-zj   → zellij（终端分屏）
-gs   → git status
-ga   → git add
-gc   → git commit
-gp   → git push
-```
-
----
-
-*最后更新：2026-01-14*

package/PROJECT_STRUCTURE.md

@@ -1,266 +0,0 @@
-# Sumulige Claude 项目详解
-
-> **Claude Code 多 Agent 编排框架** - 专为 AI 理解优化
-
----
-
-## 📌 项目定位
-
-**Sumulige Claude** 是一个 **Claude Code 多 Agent 编排框架**，核心目标是让 AI 辅助开发更智能、更高效。
-
-基于 CLI 的 AI 辅助开发与管理系统（包含技能库、RAG 索引、任务追踪等）。
-
-### 核心功能
-
-| 功能 | 描述 |
-|------|------|
-| **多 Agent 协作** | 5个专业化 Agent（Conductor/Architect/Builder/Reviewer/Librarian）分工协作 |
-| **技能市场** | 发现、安装和同步外部技能（v1.0.8 新增） |
-| **技能系统** | 可复用的 Claude Skills 管理（安装/创建/依赖检查） |
-| **版本迁移** | 自动检测并迁移旧格式项目（v1.0.11 新增） |
-| **项目模板** | 一键部署完整的 Claude Code 项目配置 |
-| **TODO 管理** | 按优先级分组的 AI 自动维护任务系统 |
-| **测试套件** | 78 个测试用例覆盖核心模块（v1.0.11 新增） |
-| **ThinkingLens** | 对话追踪和增量记忆系统 |
-
-### Agent 角色说明
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                     Agent 团队架构                          │
-├─────────────────────────────────────────────────────────────┤
-│  Conductor   → 任务分解和协调（项目经理）                    │
-│  Architect   → 架构设计和技术决策（架构师）                  │
-│  Builder     → 代码实现和测试（工程师）                      │
-│  Reviewer    → 代码审查和质量检查（审查员）                  │
-│  Librarian   → 文档编写和知识整理（文档员）                  │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 📁 项目结构 ASCII 树
-
-```
-sumulige-claude/
-├── .claude/                          # CLI 工具自身的 Claude Code 配置
-│   ├── rag/                          # RAG 技能索引
-│   ├── sessions/                     # 会话追踪
-│   ├── skills/                       # 内置技能
-│   │   └── api-tester/               # API 测试技能示例
-│   ├── AGENTS.md                     # Agent 配置
-│   ├── README.md                     # Claude 项目说明
-│   └── settings.local.json           # 本地配置
-│
-├── lib/                              # ⭐ 核心库模块（v1.0.6+ 重构）
-│   ├── commands.js                   # 命令实现（~700 行）
-│   ├── config.js                     # 配置管理（~70 行）
-│   ├── marketplace.js                # 技能市场功能（v1.0.8 新增）
-│   ├── migrations.js                 # 版本迁移系统（v1.0.11 新增）
-│   └── utils.js                      # 公共工具函数（~60 行）
-│
-├── config/                           # ⭐ 默认配置（v1.0.6+ 新增）
-│   ├── defaults.json                 # 默认配置文件
-│   └── skill-categories.json         # 技能分类（v1.0.8 新增）
-│
-├── scripts/                          # ⭐ 自动化脚本（v1.0.8 新增）
-│   ├── sync-external.mjs             # 外部技能同步引擎
-│   └── update-registry.mjs           # 市场注册表生成器
-│
-├── tests/                            # ⭐ 测试套件（v1.0.11 新增）
-│   ├── *.test.js                     # 单元测试（78 tests）
-│   ├── fixtures/                     # 测试夹具
-│   ├── mocks/                        # Mock 数据
-│   └── README.md                     # 测试文档
-│
-├── docs/                             # ⭐ 开发文档（v1.0.8 新增）
-│   ├── DEVELOPMENT.md                # 开发指南
-│   └── MARKETPLACE.md                # 技能市场指南
-│
-├── .claude-plugin/                   # ⭐ Claude Code 插件（v1.0.8 新增）
-│   └── marketplace.json              # 技能市场注册表
-│
-├── .github/                          # CI/CD 配置（v1.0.8 新增）
-│   └── workflows/
-│       └── sync-skills.yml           # 每日技能同步
-│
-├── sources.yaml                      # 外部技能源配置（v1.0.8 新增）
-│
-├── development/                      # 开发任务管理
-│   └── todos/                        # TODO 任务系统（GTD 风格）
-│       ├── active/                   # 🚧 进行中任务
-│       ├── backlog/                  # 📋 待办任务
-│       ├── completed/                # ✅ 已完成任务
-│       ├── archived/                 # 📦 已归档任务
-│       └── INDEX.md                  # 任务总览（可点击跳转）
-│
-├── template/                         # ⭐ 项目模板（smc template 部署）
-│   ├── .claude/                      # Claude Code 完整配置
-│   │   ├── commands/                 # Slash 命令（9个）
-│   │   │   ├── commit-push-pr.md     # /commit-push-pr
-│   │   │   ├── commit.md             # /commit
-│   │   │   ├── pr.md                 # /pr
-│   │   │   ├── review.md             # /review
-│   │   │   ├── sessions.md           # /sessions
-│   │   │   ├── skill-create.md       # /skill-create
-│   │   │   ├── test.md               # /test
-│   │   │   ├── todos.md              # /todos
-│   │   │   └── verify-work.md        # /verify-work
-│   │   │
-│   │   ├── hooks/                    # 自动化 Hook 脚本
-│   │   │
-│   │   ├── rag/                      # RAG 技能索引
-│   │   │   └── skill-index.json      # 20+ 技能索引（支持关键词匹配）
-│   │   │
-│   │   ├── skills/                   # 项目技能库
-│   │   │   ├── examples/             # 示例技能
-│   │   │   ├── manus-kickoff/        # Manus 风格项目启动技能
-│   │   │   ├── template/             # 技能创建模板
-│   │   │   └── SKILLS.md             # 技能索引说明
-│   │   │
-│   │   ├── templates/                # 项目文档模板
-│   │   │   ├── PROJECT_KICKOFF.md    # 项目启动清单
-│   │   │   ├── PROJECT_PROPOSAL.md   # 项目计划书模板
-│   │   │   └── TASK_PLAN.md          # 任务执行计划模板
-│   │   │
-│   │   ├── thinking-routes/          # 思维轨迹系统
-│   │   │
-│   │   ├── CLAUDE-template.md        # CLAUDE.md 模板
-│   │   ├── README.md                 # 项目说明（AI 首先读取）
-│   │   ├── boris-optimizations.md    # Boris 最佳实践
-│   │   └── settings.json             # Claude Code 设置
-│   │
-│   ├── development/                  # 开发任务管理模板
-│   │   └── todos/                    # TODO 系统模板
-│   │
-│   ├── prompts/                      # 教学资源
-│   │   └── how-to-find.md            # 对话查找指南
-│   │
-│   ├── CLAUDE-template.md            # CLAUDE.md 模板
-│   ├── README.md                     # 模板说明
-│   ├── init.sh                       # 初始化脚本
-│   ├── project-paradigm.md           # 项目开发范式
-│   └── thinkinglens-silent.md        # ThinkingLens 静默指令
-│
-├── cli.js                            # ⭐ CLI 入口（~120 行，数据驱动）
-├── package.json                      # npm 包配置
-├── package-lock.json                 # 依赖锁定
-├── AGENTS.md                         # Agent 配置说明
-├── README.md                         # 项目文档（858 行）
-├── PROJECT_STRUCTURE.md              # 本文件
-├── Q&A.md                            # 常见问题
-└── .gitignore                        # Git 忽略规则
-```
-
----
-
-## 🔧 CLI 命令速查
-
-```
-smc (sumulige-claude 简写)
-├── init                  # 初始化配置 (~/.claude/config.json)
-├── status                # 查看状态（Agents/Skills/Tasks）
-├── sync                  # 同步配置到项目（自动执行迁移）
-├── migrate               # 手动执行项目迁移（v1.0.11 新增）
-├── template [path]       # 部署项目模板
-├── kickoff               # Manus 风格项目规划启动
-│
-├── skill:list            # 列出所有技能
-├── skill:create <name>   # 创建新技能
-├── skill:check [name]    # 检查技能依赖
-├── skill:install <src>   # 安装外部技能
-│
-├── marketplace:list      # 列出市场技能（v1.0.8 新增）
-├── marketplace:install   # 安装市场技能
-├── marketplace:sync      # 同步外部技能源
-├── marketplace:add       # 添加技能源
-├── marketplace:remove    # 移除技能源
-├── marketplace:status    # 查看市场状态
-│
-└── agent <task>          # 启动 Agent 编排
-```
-
----
-
-## 📊 关键数据结构
-
-### 配置文件结构 (`~/.claude/config.json`)
-
-```json
-{
-  "version": "1.0.0",
-  "agents": {
-    "conductor": { "model": "claude-opus-4.5", "role": "Task coordination" },
-    "architect": { "model": "claude-opus-4.5", "role": "Architecture design" },
-    "builder":   { "model": "claude-opus-4.5", "role": "Code implementation" },
-    "reviewer":  { "model": "claude-opus-4.5", "role": "Code review" },
-    "librarian": { "model": "claude-opus-4.5", "role": "Documentation" }
-  },
-  "skills": ["anthropics/skills", "numman-ali/n-skills"],
-  "thinkingLens": { "enabled": true, "autoSync": true, "syncInterval": 20 }
-}
-```
-
-### RAG 技能索引结构 (`skill-index.json`)
-
-```json
-{
-  "skills": [
-    {
-      "name": "frontend-design",
-      "keywords": ["frontend", "ui", "react"],
-      "description": "前端界面设计"
-    },
-    {
-      "name": "mcp-builder",
-      "keywords": ["api", "mcp", "server"],
-      "description": "MCP 服务器构建"
-    }
-  ]
-}
-```
-
----
-
-## 🔄 工作流程图
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                 Manus 风格工作流                             │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  1. smc template      → 部署项目模板                        │
-│         ↓                                                   │
-│  2. smc kickoff       → AI 生成 TASK_PLAN.md               │
-│         ↓                                                   │
-│  3. Human 确认        → 审批项目计划                        │
-│         ↓                                                   │
-│  4. Agent 协作执行    → Conductor 分配 → Builder 实现       │
-│         ↓                                                   │
-│  5. ThinkingLens      → 自动记录 MEMORY.md + PROJECT_LOG   │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 🎯 AI 理解要点
-
-1. **入口文件**: `cli.js` 是 Node.js CLI 工具，通过 npm 全局安装后使用 `smc` 命令
-2. **模板目录**: `template/` 包含完整的 Claude Code 项目配置，通过 `smc template` 复制到目标项目
-3. **技能系统**: 基于 markdown 文件定义，存储在 `.claude/skills/` 目录
-4. **TODO 系统**: 采用文件夹分组（active/backlog/completed/archived）+ INDEX.md 索引
-5. **RAG 索引**: `skill-index.json` 支持关键词自动匹配技能
-
----
-
-## 📦 技术栈
-
-- **运行环境**: Node.js
-- **包管理**: npm
-- **发布平台**: [npmjs.com/package/sumulige-claude](https://www.npmjs.com/package/sumulige-claude)
-- **源码仓库**: [github.com/sumulige/sumulige-claude](https://github.com/sumulige/sumulige-claude)
-
----
-
-*Generated: 2026-01-15*