@dtt_siye/atool

v1.4.0

Published

18 hours ago

AI Developer Toolkit - 一键配置 AI IDE 的工具集

0High
0Medium
0Low

roselifeye

ai claude cursor kiro ide developer-tools

aTool - AI 开发者工具集

一键配置 AI IDE 的 Skills、MCP Servers、Hooks 和项目规则。让任何水平的开发者，通过在 IDE 中正常聊天，就能获得资深架构师的判断力、高级工程师的代码质量标准、和技术文档专家的交付质量。

两种安装方式，30 秒完成配置：

# 方式一：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%） |

核心理念

开箱即用 — 安装后在 IDE 中正常聊天，AI 自动加载工作流和编码规范
项目自适应 — 自动检测 17 种技术栈，匹配对应编码规范（零配置）
老旧代码分析 — 多 Agent 并行深度分析，5 分钟理解 30 分钟的代码
文档自动同步 — 代码修改后自动提醒并更新文档，确保交付质量

快速开始

npm 安装（推荐）

# 一键安装到所有 IDE
npx @dtt_siye/atool

# 或全局安装后使用
npm install -g @dtt_siye/atool
atool                    # 安装到所有 IDE
atool --project ./my-app # 初始化项目

从源码安装

# 1. 安装到所有 IDE
./install.sh --all --yes

# 2. 初始化项目（自动检测技术栈 + 生成规则模板）
./install.sh --project /path/to/your/project

# 或在 Claude Code 中一步到位：
# /atool-init

详细安装指南参见 docs/02-getting-started.md

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 名称，正常聊天即可触发：

意图澄清（防幻觉） → 栈感知（自动规范） → 质量闭环（文档同步）

用户说「帮我写个用户注册接口」→ AI 自动评估复杂度 → 问清需求 → 按 Spring 分层规范生成代码 → 自动更新文档 → 完成前验证

详见 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

Hooks（3 个自动拦截）

| Hook | 触发时机 | 作用 | |------|----------|------| | session-start | 每次新会话 | 注入 Skill 目录 + 项目栈 + 文档状态 + 澄清规则 | | prompt-guard | 每条用户消息 | 实现类请求时注入澄清提醒（Tier 0-3 分级） | | doc-sync-reminder | Write/Edit 后 | 源码变更后检查文档新鲜度，过期时提醒同步 |

详见 docs/05-hooks.md

MCP Servers（5 个）

context7（文档查询）, filesystem（文件访问）, git（版本控制）, sequential-thinking（结构化推理）, playwright（浏览器自动化）

详见 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/01-overview.md | 项目概览 — 文档中心首页，含目录索引和阅读路径 | | docs/02-getting-started.md | 快速开始 — 安装指南、环境检查、各 IDE 使用方式 | | docs/03-workflow.md | 工作流全景图 — 端到端流程、三层防线、IDE 对比、用户旅程 | | docs/04-skills.md | Skills 系统 — 30 个 skill 详解、触发机制、开发规范 | | docs/05-hooks.md | Hooks 系统 — 3 个 hook 触发链、配置方式、跨 IDE 适配 | | docs/06-templates.md | 模板系统 — 14 种技术栈检测、模板生成、变量替换 | | docs/07-mcp-servers.md | MCP 服务器 — 5 个推荐服务器配置说明 | | docs/08-ide-support.md | IDE 支持 — Claude Code / Cursor / Kiro 能力对比、适配策略 | | docs/09-architecture.md | 系统架构设计 — 模块结构、数据流、关键设计决策 | | docs/10-testing.md | 测试指南 — 16 个测试套件、Fixture 说明、编写新测试 | | docs/11-advanced-features.md | 高级功能 — Agent 定义、jq 自动下载、环境变量、Monorepo | | docs/12-contributing.md | 贡献指南 — 开发规范、测试、添加新 skill/技术栈 |

平台支持

| | macOS | Linux | Windows | |---|:-----:|:-----:|:-------:| | 安装脚本 | ✅ | ✅ | ✅ Git Bash / WSL | | 全部功能 | ✅ | ✅ | ✅ | | IDE 支持 | ✅ | ✅ | ✅ |

更新与卸载

# 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。

项目结构

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/                   # 项目文档

开发

# 运行全部测试
./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。