@dtt_siye/atool 1.4.0 → 1.5.0

package/README.md

@@ -1,255 +1,138 @@
-# aTool - AI 开发者工具集
+# @dtt_siye/atool
 
-[![npm version](https://img.shields.io/npm/v/@dtt_siye/atool.svg)](https://www.npmjs.com/package/@dtt_siye/atool)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Shell](https://img.shields.io/badge/shell-bash-4EAA25.svg)](install.sh)
+AI Developer Toolkit - 一键配置 AI IDE 的工具集
 
-> 一键配置 AI IDE 的 Skills、MCP Servers、Hooks 和项目规则。让任何水平的开发者，通过在 IDE 中正常聊天，就能获得资深架构师的判断力、高级工程师的代码质量标准、和技术文档专家的交付质量。
+## 技术栈
 
-**两种安装方式，30 秒完成配置：**
+- **检测类型**: generic
 
-```bash
-# 方式一：npm 安装（推荐，全局可用）
-npx @dtt_siye/atool
-
-# 方式二：从源码安装
-git clone --recursive https://github.com/user/atool.git && cd atool
-./install.sh --all --yes
-```
-
----
-
-## 支持的 IDE
-
-| IDE | Skills | Hooks | 强制执行 | 特色 |
-|-----|--------|-------|---------|------|
-| **Claude Code** | ✅ SKILL.md | ✅ 全局（3 个） | **高** | Slash 命令 + 并行 Agent |
-| **Cursor** | ✅ .mdc Rules | ⚠️ 项目级（3 个） | **中** | alwaysApply + globs 智能加载 |
-| **Kiro** | ✅ Steering Markdown | ❌ | **低** | 合并精简 43→~8 文件（token -87%） |
-
----
-
-## 核心理念
-
-1. **开箱即用** — 安装后在 IDE 中正常聊天，AI 自动加载工作流和编码规范
-2. **项目自适应** — 自动检测 17 种技术栈，匹配对应编码规范（零配置）
-3. **老旧代码分析** — 多 Agent 并行深度分析，5 分钟理解 30 分钟的代码
-4. **文档自动同步** — 代码修改后自动提醒并更新文档，确保交付质量
-
----
-
-## 快速开始
-
-### npm 安装（推荐）
+## 🚀 性能优化：SKILL.md 精简架构
 
-```bash
-# 一键安装到所有 IDE
-npx @dtt_siye/atool
-
-# 或全局安装后使用
-npm install -g @dtt_siye/atool
-atool                    # 安装到所有 IDE
-atool --project ./my-app # 初始化项目
-```
+aTool 已实现 **"SKILL.md 精简 + 按需加载"** 架构优化：
 
-### 从源码安装
+### 📊 优化成果
 
-```bash
-# 1. 安装到所有 IDE
-./install.sh --all --yes
-
-# 2. 初始化项目（自动检测技术栈 + 生成规则模板）
-./install.sh --project /path/to/your/project
-
-# 或在 Claude Code 中一步到位：
-# /atool-init
-```
+| 指标 | 重构前 | 重构后 | 改进 |
+|------|--------|--------|------|
+| SKILL.md 总行数 | ~8,900 行 | ~4,200 行 | ↓53% |
+| 超过 200 行的 skill | 25 个 | 0 个 | ↓100% |
+| 单次调用 token 消耗 | ~6,000 | ~2,000 | ↓67% |
 
-> 详细安装指南参见 [docs/02-getting-started.md](docs/02-getting-started.md)
+### ⚡ 按需加载机制
 
----
+- **精简入口**: 每个 SKILL.md ≤150 行，仅包含核心信息
+- **模块化内容**: 详细规则拆分到 `rules/`、`phases/`、`references/` 子目录
+- **智能加载**: AI 根据查询只读取相关文件，避免全量加载
 
-## CLI 选项
-
-| 选项 | 描述 |
-|------|------|
-| `--all` | 安装到所有已检测到的 IDE |
-| `--claude` / `--cursor` / `--kiro` | 仅安装到指定 IDE |
-| `--project PATH` | 初始化项目（检测技术栈 + 生成模板） |
-| `--analyze PATH` | 准备项目深度分析目录（配合 project-analyze skill） |
-| `--update` | 一步式更新（git pull + 自动重装变更组件） |
-| `--uninstall` | 移除所有 aTool 配置 |
-| `--dry-run` | 预览模式，不做任何实际修改 |
-| `--force` | 强制覆盖（默认：合并 + 备份） |
-| `--check-updates` | 检查更新（不安装） |
-| `--yes` | 跳过确认提示 |
-| `--version` / `--help` | 版本号 / 帮助信息 |
-
----
-
-## 工作流全景
+## 项目结构
 
-aTool 通过三层自动化防线串联所有功能，用户无需知道 skill 名称，正常聊天即可触发：
+> 由 `project-analyze` skill 自动填充
 
 ```
-意图澄清（防幻觉） → 栈感知（自动规范） → 质量闭环（文档同步）
+├── src/                # 源代码
+├── tests/              # 测试
+├── docs/               # 文档
+│   ├── 04-skills.md   # Skills 系统文档（已更新）
+│   └── ...
+├── skills/            # Skills 目录
+│   ├── java-conventions/    # 精简架构示例
+│   │   ├── SKILL.md        # ≤150 行精简入口
+│   │   └── rules/          # 详细规则（按需加载）
+│   ├── project-query/       # 重构后 115 行
+│   ├── software-architecture/ # 重构后 116 行
+│   └── ...
+├── lib/               # 安装脚本
+│   ├── install-cursor.sh   # 已更新支持子目录
+│   └── ...
+├── config/             # 配置
+└── README.md           # 项目说明
 ```
 
-**用户说「帮我写个用户注册接口」→** AI 自动评估复杂度 → 问清需求 → 按 Spring 分层规范生成代码 → 自动更新文档 → 完成前验证
-
-详见 [docs/03-workflow.md](docs/03-workflow.md) — 含交互式流程图、三层泳道图、IDE 对比、用户旅程
+## 架构设计
 
----
+> 由 `project-analyze` skill 自动填充
 
-## 功能一览
+## 🌟 特色功能
 
-### Skills（31 个）
+### 1. 智能技能系统
+- **47+ 专业技能**: 涵盖 Java、Web、Python、Rust、Go 等主流技术栈
+- **自动触发**: 根据项目类型自动应用相应规范
+- **按需加载**: 仅加载相关技能内容，提升性能
 
-| 类型 | 数量 | 代表 Skills |
-|------|:----:|------------|
-| 技术栈规范 | 11 | java-conventions, web-conventions, python-conventions, go-conventions ... |
-| 项目分析 | 1 | project-analyze — v5.0 五维分析框架，14 节点 × 24 边知识图谱，Cytoscape.js 可视化，8 因子评分，断点续传 |
-| 项目查询 | 1 | project-query — 分析结果结构化查询系统 |
-| 代码审查 | 1 | code-review — 8 维度评分 + CODE_REVIEW.md 报告 |
-| 架构设计 | 1 | software-architecture — 风格选型 + 高并发 + DDD |
-| 工作流 | 4 | brainstorming, clarify-before-build, smart-dispatch, writing-plans |
-| 社区核心 | 6 | ai-project-architecture, doc-coauthoring, ui-ux-pro, webapp-testing ... |
-| Office | 4 | pdf, docx, pptx, xlsx |
-| Superpowers | ~15 | using-superpowers, TDD, debugging, verification ... |
+### 2. 多 IDE 支持
+- **Claude Code**: 原生支持，自动补全性能提升
+- **Cursor**: 自动生成 .mdc 规则文件
+- **Kiro**: 自动生成 steering 导航文件
 
-详见 [docs/04-skills.md](docs/04-skills.md)
+### 3. 项目分析能力
+- **深度分析**: 7 阶段管线，5 维度分析框架
+- **知识图谱**: 14 节点 × 24 边依赖关系可视化
+- **文档生成**: 自动生成 Zero-KT 标准项目文档
 
-### Hooks（3 个自动拦截）
-
-| Hook | 触发时机 | 作用 |
-|------|----------|------|
-| session-start | 每次新会话 | 注入 Skill 目录 + 项目栈 + 文档状态 + 澄清规则 |
-| prompt-guard | 每条用户消息 | 实现类请求时注入澄清提醒（Tier 0-3 分级） |
-| doc-sync-reminder | Write/Edit 后 | 源码变更后检查文档新鲜度，过期时提醒同步 |
-
-详见 [docs/05-hooks.md](docs/05-hooks.md)
-
-### MCP Servers（5 个）
-
-context7（文档查询）, filesystem（文件访问）, git（版本控制）, sequential-thinking（结构化推理）, playwright（浏览器自动化）
-
-详见 [docs/07-mcp-servers.md](docs/07-mcp-servers.md)
-
-### 技术栈检测（17 种）
-
-Java/Spring, React/Next.js, Vue/Nuxt, Svelte, Python, Go, Rust/Tauri, Android, iOS/Swift, Flutter, React Native, HarmonyOS, DevOps/K8s — 自动检测，零配置。
-
-### 项目模板
-
-根据技术栈自动生成 `CLAUDE.md` + `README.md` + `COMPONENT.md` + `UI_STYLE.md` + Cursor rules + Kiro steering，含真实项目数据（组件清单、路由表、依赖信息等）。
-
-详见 [docs/06-templates.md](docs/06-templates.md)
-
----
-
-## 文档目录
+## 快速开始
 
-| 文档 | 内容 |
-|------|------|
-| [docs/01-overview.md](docs/01-overview.md) | 项目概览 — 文档中心首页，含目录索引和阅读路径 |
-| [docs/02-getting-started.md](docs/02-getting-started.md) | 快速开始 — 安装指南、环境检查、各 IDE 使用方式 |
-| [docs/03-workflow.md](docs/03-workflow.md) | 工作流全景图 — 端到端流程、三层防线、IDE 对比、用户旅程 |
-| [docs/04-skills.md](docs/04-skills.md) | Skills 系统 — 30 个 skill 详解、触发机制、开发规范 |
-| [docs/05-hooks.md](docs/05-hooks.md) | Hooks 系统 — 3 个 hook 触发链、配置方式、跨 IDE 适配 |
-| [docs/06-templates.md](docs/06-templates.md) | 模板系统 — 14 种技术栈检测、模板生成、变量替换 |
-| [docs/07-mcp-servers.md](docs/07-mcp-servers.md) | MCP 服务器 — 5 个推荐服务器配置说明 |
-| [docs/08-ide-support.md](docs/08-ide-support.md) | IDE 支持 — Claude Code / Cursor / Kiro 能力对比、适配策略 |
-| [docs/09-architecture.md](docs/09-architecture.md) | 系统架构设计 — 模块结构、数据流、关键设计决策 |
-| [docs/10-testing.md](docs/10-testing.md) | 测试指南 — 16 个测试套件、Fixture 说明、编写新测试 |
-| [docs/11-advanced-features.md](docs/11-advanced-features.md) | 高级功能 — Agent 定义、jq 自动下载、环境变量、Monorepo |
-| [docs/12-contributing.md](docs/12-contributing.md) | 贡献指南 — 开发规范、测试、添加新 skill/技术栈 |
+### 1. 安装 aTool
 
----
+```bash
+# 克隆项目
+git clone https://github.com/your-username/atool.git
+cd atool
 
-## 平台支持
+# 安装到 Claude Code
+./install.sh --claude
 
-| | macOS | Linux | Windows |
-|---|:-----:|:-----:|:-------:|
-| 安装脚本 | ✅ | ✅ | ✅ Git Bash / WSL |
-| 全部功能 | ✅ | ✅ | ✅ |
-| IDE 支持 | ✅ | ✅ | ✅ |
+# 安装到 Cursor
+./install.sh --cursor
 
----
+# 安装到所有 IDE
+./install.sh --all
+```
 
-## 更新与卸载
+### 2. 初始化项目
 
 ```bash
-# npm 方式
-npm update -g @dtt_siye/atool    # 更新
-atool --all --yes                # 重新安装
-npm uninstall -g @dtt_siye/atool # 卸载 npm 包
-atool --uninstall                # 移除配置
-
-# 源码方式
-./install.sh --update            # 一步式更新
-./install.sh --check-updates     # 检查更新
-./install.sh --uninstall         # 移除配置
-```
+# 在项目目录中运行
+./install.sh --project .
 
-更新策略：Skills 按内容 checksum 增量更新，Cursor/Kiro staging 按 checksum 比较，MCP 使用 JSON 深度合并，Hooks 按 MD5 校验。详见 [docs/09-architecture.md](docs/09-architecture.md)。
+# 或使用 aTool CLI
+atool init
+```
 
----
+### 3. 使用技能
 
-## 项目结构
+```bash
+# 在 Claude Code 中使用自动补全
+/java-conventions
+/software-architecture
+/project-analyze
 
+# 查看所有技能
+/skills
 ```
-aTool/
-├── install.sh              # 主入口（CLI 参数解析 + 安装调度）
-├── VERSION                 # 版本号
-├── lib/                    # 核心库（15 个模块）
-│   ├── common.sh           # 公共函数、日志、JSON 工具、模板替换、版本检测
-│   ├── detect-stack.sh     # 技术栈检测引擎（17 种）
-│   ├── analyze-source.sh   # 源码分析模块（18+ 扫描函数）
-│   ├── project-init.sh     # 项目初始化（monorepo + 单项目）
-│   ├── install-{skills,hooks,mcp,claude,cursor,kiro}.sh
-│   ├── compute-importance.sh  # 模块重要性评分（8 因子加权）
-│   ├── knowledge-graph.sh     # 知识图谱工具（v5.0 共 11 个公开函数，CK 度量，介数中心性）
-│   ├── multi-dimensional-analysis.sh  # 五维分析框架（结构/行为/数据/质量/语义）
-│   ├── generate-visualization.sh      # Cytoscape.js 知识图谱可视化生成
-│   └── visualization-template.html    # 可视化 HTML 模板
-├── skills/                 # Skills 集合（31 个）
-│   ├── _superpowers/       # Superpowers git submodule（v5.0.6）
-│   ├── {11 conventions}/   # 技术栈编码规范
-│   ├── project-analyze/    # 深度项目分析 v5.0（五维分析 + 知识图谱 + 可视化 + 8 因子评分）
-│   ├── project-query/      # 分析结果结构化查询系统
-│   ├── code-review/        # 代码质量审查 v0.3
-│   ├── software-architecture/  # 架构设计 v1.0
-│   ├── smart-dispatch/     # 并行计划执行
-│   └── {community,office}/ # 社区 + Office skills
-├── hooks/                  # Hook 脚本（session-start, prompt-guard, doc-sync-reminder）
-├── mcp/                    # MCP 服务器配置
-├── templates/              # 项目模板（79 个文件，13 栈 × 6 类型 + 1 monorepo）
-├── agents/                 # Agent 规则定义
-├── tests/                  # 测试（15 个套件 + 1 runner，850+ 用例）
-└── docs/                   # 项目文档
-```
-
----
-
-## 开发
 
-```bash
-# 运行全部测试
-./tests/test-run-all.sh
+## 开发规范
 
-# 单个测试
-./tests/test-detect-stack.sh       # 技术栈检测（47 用例）
-./tests/test-skill-conversion.sh   # Skill 格式转换（45 用例）
-./tests/test-core-workflows.sh     # 核心链路集成（61 用例）
+### 代码规范技能
+- **java-conventions**: Java/Spring Boot 开发规范
+- **web-conventions**: React/Vue/Web 开发规范
+- **python-conventions**: Python/FastAPI 开发规范
+- **rust-conventions**: Rust/Cargo 开发规范
 
-# Dry-run 预览
-./install.sh --dry-run --all
-```
+### 架构设计技能
+- **software-architecture**: 系统架构设计指导
+- **ai-project-architecture**: AI 项目架构合规检查
+- **project-analyze**: 深度项目分析
 
-欢迎贡献！详见 [docs/12-contributing.md](docs/12-contributing.md)。
+### 工作流技能
+- **brainstorming**: 创意工作流程
+- **writing-plans**: 计划制定
+- **code-review**: 代码审查
+- **systematic-debugging**: 系统性调试
 
----
+## 模块说明
 
-## 许可证
+> 由 `project-analyze` skill 自动填充
 
-[MIT License](LICENSE) - Copyright (c) 2025 aTool Contributors
+| 模块 | 描述 |
+|------|------|
+| | |

package/README.md.atool-backup.20260410_114701

@@ -0,0 +1,299 @@
+# aTool - AI 开发者工具集
+
+[![npm version](https://img.shields.io/npm/v/@dtt_siye/atool.svg)](https://www.npmjs.com/package/@dtt_siye/atool)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Shell](https://img.shields.io/badge/shell-bash-4EAA25.svg)](install.sh)
+
+> 一键配置 AI IDE 的 Skills、MCP Servers、Hooks 和项目规则。让任何水平的开发者，通过在 IDE 中正常聊天，就能获得资深架构师的判断力、高级工程师的代码质量标准、和技术文档专家的交付质量。
+
+**两种安装方式，30 秒完成配置：**
+
+```bash
+# 方式一：npm 安装（推荐，全局可用）
+npx @dtt_siye/atool
+
+# 方式二：从源码安装
+git clone --recursive https://github.com/user/atool.git && cd atool
+./install.sh --all --yes
+```
+
+---
+
+## 支持的 IDE
+
+| IDE | Skills | Hooks | 强制执行 | 特色 |
+|-----|--------|-------|---------|------|
+| **Claude Code** | ✅ SKILL.md | ✅ 全局（3 个） | **高** | Slash 命令 + 并行 Agent |
+| **Cursor** | ✅ .mdc Rules | ⚠️ 项目级（3 个） | **中** | alwaysApply + globs 智能加载 |
+| **Kiro** | ✅ Steering Markdown | ❌ | **低** | 合并精简 43→~8 文件（token -87%） |
+
+---
+
+## 核心理念
+
+1. **开箱即用** — 安装后在 IDE 中正常聊天，AI 自动加载工作流和编码规范
+2. **项目自适应** — 自动检测 17 种技术栈，匹配对应编码规范（零配置）
+3. **老旧代码分析** — 多 Agent 并行深度分析，5 分钟理解 30 分钟的代码
+4. **文档自动同步** — 代码修改后自动提醒并更新文档，确保交付质量
+
+---
+
+## 快速开始
+
+### npm 安装（推荐）
+
+```bash
+# 一键安装到所有 IDE
+npx @dtt_siye/atool
+
+# 或全局安装后使用
+npm install -g @dtt_siye/atool
+
+# 基础安装
+atool install              # 安装到所有 IDE
+atool install --claude     # 仅安装到 Claude Code
+
+# 项目初始化
+atool init                 # 初始化当前目录项目
+atool init ./my-app        # 初始化指定目录项目
+atool init --stack react   # 指定技术栈初始化
+```
+
+### 从源码安装
+
+```bash
+# 1. 安装到所有 IDE
+./install.sh --all --yes
+
+# 2. 初始化项目（自动检测技术栈 + 生成规则模板）
+./install.sh --project /path/to/your/project
+# 或
+./install.sh --project --stack react /path/to/your/project
+
+# 或在 Claude Code 中一步到位：
+# /atool-init
+```
+
+> 详细安装指南参见 [docs/02-getting-started.md](docs/02-getting-started.md)
+
+---
+
+## CLI 命令
+
+### 安装命令
+
+```bash
+atool install              # 安装到所有 IDE（默认）
+atool install --claude     # 仅安装到 Claude Code
+atool install --cursor     # 仅安装到 Cursor
+atool install --kiro       # 仅安装到 Kiro
+atool install --all        # 安装到所有 IDE（显式）
+atool install --yes        # 跳过确认提示
+atool install --dry-run    # 预览模式
+```
+
+### 项目初始化
+
+```bash
+atool init                    # 初始化当前目录项目
+atool init ./my-app           # 初始化指定目录项目
+atool init --stack react      # 指定 React 技术栈
+atool init --stack vue        # 指定 Vue 技术栈
+atool init --stack java       # 指定 Java 技术栈
+atool init --stack python     # 指定 Python 技术栈
+```
+
+### 其他命令
+
+```bash
+atool update                 # 更新 aTool
+atool check-updates         # 检查更新（JSON 格式）
+atool version                # 显示版本
+atool help                   # 显示帮助
+```
+
+## CLI 选项
+
+| 选项 | 描述 |
+|------|------|
+| `--all` | 安装到所有已检测到的 IDE |
+| `--claude` / `--cursor` / `--kiro` | 仅安装到指定 IDE |
+| `--project PATH` | 初始化项目（兼容旧版本，推荐使用 `atool init`） |
+| `--analyze PATH` | 准备项目深度分析目录（配合 project-analyze skill） |
+| `--stack STACK` | 指定技术栈（如 react、vue、java、python） |
+| `--update` | 一步式更新（git pull + 自动重装变更组件） |
+| `--uninstall` | 移除所有 aTool 配置 |
+| `--dry-run` | 预览模式，不做任何实际修改 |
+| `--force` | 强制覆盖（默认：合并 + 备份） |
+| `--check-updates` | 检查更新（不安装） |
+| `--yes` | 跳过确认提示 |
+| `--version` / `--help` | 版本号 / 帮助信息 |
+
+---
+
+## 工作流全景
+
+aTool 通过三层自动化防线串联所有功能，用户无需知道 skill 名称，正常聊天即可触发：
+
+```
+意图澄清（防幻觉） → 栈感知（自动规范） → 质量闭环（文档同步）
+```
+
+**用户说「帮我写个用户注册接口」→** AI 自动评估复杂度 → 问清需求 → 按 Spring 分层规范生成代码 → 自动更新文档 → 完成前验证
+
+详见 [docs/03-workflow.md](docs/03-workflow.md) — 含交互式流程图、三层泳道图、IDE 对比、用户旅程
+
+---
+
+## 功能一览
+
+### Skills（31 个）
+
+| 类型 | 数量 | 代表 Skills |
+|------|:----:|------------|
+| 技术栈规范 | 11 | java-conventions, web-conventions, python-conventions, go-conventions ... |
+| 项目分析 | 1 | project-analyze — v5.0 五维分析框架，14 节点 × 24 边知识图谱，Cytoscape.js 可视化，8 因子评分，断点续传 |
+| 项目查询 | 1 | project-query — 分析结果结构化查询系统 |
+| 代码审查 | 1 | code-review — 8 维度评分 + CODE_REVIEW.md 报告 |
+| 架构设计 | 1 | software-architecture — 风格选型 + 高并发 + DDD |
+| 工作流 | 4 | brainstorming, clarify-before-build, smart-dispatch, writing-plans |
+| 社区核心 | 6 | ai-project-architecture, doc-coauthoring, ui-ux-pro, webapp-testing ... |
+| Office | 4 | pdf, docx, pptx, xlsx |
+| Superpowers | ~15 | using-superpowers, TDD, debugging, verification ... |
+
+详见 [docs/04-skills.md](docs/04-skills.md)
+
+### Hooks（3 个自动拦截）
+
+| Hook | 触发时机 | 作用 |
+|------|----------|------|
+| session-start | 每次新会话 | 注入 Skill 目录 + 项目栈 + 文档状态 + 澄清规则 |
+| prompt-guard | 每条用户消息 | 实现类请求时注入澄清提醒（Tier 0-3 分级） |
+| doc-sync-reminder | Write/Edit 后 | 源码变更后检查文档新鲜度，过期时提醒同步 |
+
+详见 [docs/05-hooks.md](docs/05-hooks.md)
+
+### MCP Servers（5 个）
+
+context7（文档查询）, filesystem（文件访问）, git（版本控制）, sequential-thinking（结构化推理）, playwright（浏览器自动化）
+
+详见 [docs/07-mcp-servers.md](docs/07-mcp-servers.md)
+
+### 技术栈检测（17 种）
+
+Java/Spring, React/Next.js, Vue/Nuxt, Svelte, Python, Go, Rust/Tauri, Android, iOS/Swift, Flutter, React Native, HarmonyOS, DevOps/K8s — 自动检测，零配置。
+
+### 项目模板
+
+根据技术栈自动生成 `CLAUDE.md` + `README.md` + `COMPONENT.md` + `UI_STYLE.md` + Cursor rules + Kiro steering，含真实项目数据（组件清单、路由表、依赖信息等）。
+
+详见 [docs/06-templates.md](docs/06-templates.md)
+
+---
+
+## 文档目录
+
+| 文档 | 内容 |
+|------|------|
+| [docs/01-overview.md](docs/01-overview.md) | 项目概览 — 文档中心首页，含目录索引和阅读路径 |
+| [docs/02-getting-started.md](docs/02-getting-started.md) | 快速开始 — 安装指南、环境检查、各 IDE 使用方式 |
+| [docs/03-workflow.md](docs/03-workflow.md) | 工作流全景图 — 端到端流程、三层防线、IDE 对比、用户旅程 |
+| [docs/04-skills.md](docs/04-skills.md) | Skills 系统 — 30 个 skill 详解、触发机制、开发规范 |
+| [docs/05-hooks.md](docs/05-hooks.md) | Hooks 系统 — 3 个 hook 触发链、配置方式、跨 IDE 适配 |
+| [docs/06-templates.md](docs/06-templates.md) | 模板系统 — 14 种技术栈检测、模板生成、变量替换 |
+| [docs/07-mcp-servers.md](docs/07-mcp-servers.md) | MCP 服务器 — 5 个推荐服务器配置说明 |
+| [docs/08-ide-support.md](docs/08-ide-support.md) | IDE 支持 — Claude Code / Cursor / Kiro 能力对比、适配策略 |
+| [docs/09-architecture.md](docs/09-architecture.md) | 系统架构设计 — 模块结构、数据流、关键设计决策 |
+| [docs/10-testing.md](docs/10-testing.md) | 测试指南 — 16 个测试套件、Fixture 说明、编写新测试 |
+| [docs/11-advanced-features.md](docs/11-advanced-features.md) | 高级功能 — Agent 定义、jq 自动下载、环境变量、Monorepo |
+| [docs/12-contributing.md](docs/12-contributing.md) | 贡献指南 — 开发规范、测试、添加新 skill/技术栈 |
+
+---
+
+## 平台支持
+
+| | macOS | Linux | Windows |
+|---|:-----:|:-----:|:-------:|
+| 安装脚本 | ✅ | ✅ | ✅ Git Bash / WSL |
+| 全部功能 | ✅ | ✅ | ✅ |
+| IDE 支持 | ✅ | ✅ | ✅ |
+
+---
+
+## 更新与卸载
+
+```bash
+# npm 方式
+npm update -g @dtt_siye/atool    # 更新
+atool --all --yes                # 重新安装
+npm uninstall -g @dtt_siye/atool # 卸载 npm 包
+atool --uninstall                # 移除配置
+
+# 源码方式
+./install.sh --update            # 一步式更新
+./install.sh --check-updates     # 检查更新
+./install.sh --uninstall         # 移除配置
+```
+
+更新策略：Skills 按内容 checksum 增量更新，Cursor/Kiro staging 按 checksum 比较，MCP 使用 JSON 深度合并，Hooks 按 MD5 校验。详见 [docs/09-architecture.md](docs/09-architecture.md)。
+
+---
+
+## 项目结构
+
+```
+aTool/
+├── install.sh              # 主入口（CLI 参数解析 + 安装调度）
+├── VERSION                 # 版本号
+├── lib/                    # 核心库（15 个模块）
+│   ├── common.sh           # 公共函数、日志、JSON 工具、模板替换、版本检测
+│   ├── detect-stack.sh     # 技术栈检测引擎（17 种）
+│   ├── analyze-source.sh   # 源码分析模块（18+ 扫描函数）
+│   ├── project-init.sh     # 项目初始化（monorepo + 单项目）
+│   ├── install-{skills,hooks,mcp,claude,cursor,kiro}.sh
+│   ├── compute-importance.sh  # 模块重要性评分（8 因子加权）
+│   ├── knowledge-graph.sh     # 知识图谱工具（v5.0 共 11 个公开函数，CK 度量，介数中心性）
+│   ├── multi-dimensional-analysis.sh  # 五维分析框架（结构/行为/数据/质量/语义）
+│   ├── generate-visualization.sh      # Cytoscape.js 知识图谱可视化生成
+│   └── visualization-template.html    # 可视化 HTML 模板
+├── skills/                 # Skills 集合（31 个）
+│   ├── _superpowers/       # Superpowers git submodule（v5.0.6）
+│   ├── {11 conventions}/   # 技术栈编码规范
+│   ├── project-analyze/    # 深度项目分析 v5.0（五维分析 + 知识图谱 + 可视化 + 8 因子评分）
+│   ├── project-query/      # 分析结果结构化查询系统
+│   ├── code-review/        # 代码质量审查 v0.3
+│   ├── software-architecture/  # 架构设计 v1.0
+│   ├── smart-dispatch/     # 并行计划执行
+│   └── {community,office}/ # 社区 + Office skills
+├── hooks/                  # Hook 脚本（session-start, prompt-guard, doc-sync-reminder）
+├── mcp/                    # MCP 服务器配置
+├── templates/              # 项目模板（79 个文件，13 栈 × 6 类型 + 1 monorepo）
+├── agents/                 # Agent 规则定义
+├── tests/                  # 测试（15 个套件 + 1 runner，850+ 用例）
+└── docs/                   # 项目文档
+```
+
+---
+
+## 开发
+
+```bash
+# 运行全部测试
+./tests/test-run-all.sh
+
+# 单个测试
+./tests/test-detect-stack.sh       # 技术栈检测（47 用例）
+./tests/test-skill-conversion.sh   # Skill 格式转换（45 用例）
+./tests/test-core-workflows.sh     # 核心链路集成（61 用例）
+
+# Dry-run 预览
+./install.sh --dry-run --all
+```
+
+欢迎贡献！详见 [docs/12-contributing.md](docs/12-contributing.md)。
+
+---
+
+## 许可证
+
+[MIT License](LICENSE) - Copyright (c) 2025 aTool Contributors

package/VERSION

@@ -1 +1 @@
-1.4.0
+1.5.0