@dtt_siye/atool 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 aTool Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,235 @@
+# aTool - AI 开发者工具集
+
+[![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](VERSION)
+[![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
+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. **文档自动同步** — 代码修改后自动提醒并更新文档，确保交付质量
+
+---
+
+## 快速开始
+
+```bash
+# 1. 安装到所有 IDE
+./install.sh --all --yes
+
+# 2. 初始化项目（自动检测技术栈 + 生成规则模板）
+./install.sh --project /path/to/your/project
+
+# 或在 Claude Code 中一步到位：
+# /atool-init
+```
+
+> 详细安装指南参见 [docs/02-getting-started.md](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](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
+# 更新（一步式：拉取代码 + 自动重装变更组件）
+./install.sh --update
+
+# 检查更新
+./install.sh --check-updates
+
+# 卸载（动态扫描并移除所有 aTool 组件）
+./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

@@ -0,0 +1 @@
+0.3.0

package/agents/code-reviewer.md

@@ -0,0 +1,29 @@
+# Code Reviewer Agent
+
+You are a thorough code reviewer. Review code changes against project conventions and best practices.
+
+## Review Checklist
+
+1. **Correctness**: Does the code do what it's supposed to? Are there logic errors?
+2. **Code Style**: Does it follow the project's language/framework conventions?
+3. **Error Handling**: Are errors properly handled and propagated?
+4. **Security**: Are there any security vulnerabilities (injection, XSS, etc.)?
+5. **Performance**: Are there obvious performance issues (N+1 queries, unnecessary allocations)?
+6. **Testing**: Are there appropriate tests? Do they cover edge cases?
+7. **Documentation**: Are public APIs documented? Is the code self-explanatory?
+
+## Review Format
+
+For each issue found:
+- **Severity**: Critical / Warning / Suggestion
+- **Location**: File and line number
+- **Description**: What the issue is
+- **Recommendation**: How to fix it
+
+## Guidelines
+
+- Be constructive, not dismissive
+- Explain why something is an issue, not just that it is
+- Acknowledge good practices when you see them
+- Prioritize issues by severity
+- Suggest specific code changes when possible

package/bin/atool.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+// @ts-check
+'use strict';
+
+const { execFileSync, execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// ── Resolve paths ────────────────────────────────────────────────────────────
+const ROOT_DIR = path.resolve(__dirname, '..');
+const VERSION_FILE = path.join(ROOT_DIR, 'VERSION');
+const INSTALL_SH = path.join(ROOT_DIR, 'install.sh');
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function readVersion() {
+  try {
+    return fs.readFileSync(VERSION_FILE, 'utf8').trim();
+  } catch {
+    return 'unknown';
+  }
+}
+
+function isWindows() {
+  return process.platform === 'win32';
+}
+
+/**
+ * Find bash executable on Windows (Git Bash or WSL).
+ * Returns the path to bash or null if not found.
+ */
+function findBashOnWindows() {
+  const candidates = [
+    // Git for Windows
+    'C:\\Program Files\\Git\\bin\\bash.exe',
+    'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
+    path.join(process.env.LOCALAPPDATA || '', 'Programs', 'Git', 'bin', 'bash.exe'),
+    path.join(process.env.PROGRAMFILES || '', 'Git', 'bin', 'bash.exe'),
+  ];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  // Try PATH lookup
+  try {
+    const which = execSync('where bash', { encoding: 'utf8' }).trim().split('\n')[0];
+    if (which && fs.existsSync(which)) return which;
+  } catch {
+    // not on PATH
+  }
+
+  return null;
+}
+
+/**
+ * Run install.sh via bash with the given arguments.
+ */
+function runInstallSh(args) {
+  const argList = Array.isArray(args) ? args : [args];
+
+  if (isWindows()) {
+    const bash = findBashOnWindows();
+    if (!bash) {
+      console.error('Error: Bash not found on Windows.');
+      console.error('Install Git for Windows (https://git-scm.com) and try again.');
+      console.error('');
+      console.error('Alternatively, run manually in Git Bash:');
+      console.error(`  bash "${INSTALL_SH}" ${argList.join(' ')}`);
+      process.exit(1);
+    }
+    execFileSync(bash, [INSTALL_SH, ...argList], {
+      stdio: 'inherit',
+      cwd: ROOT_DIR,
+      env: { ...process.env, ATOOL_ROOT: ROOT_DIR },
+    });
+  } else {
+    // macOS / Linux — delegate directly to bash
+    execFileSync('bash', [INSTALL_SH, ...argList], {
+      stdio: 'inherit',
+      cwd: ROOT_DIR,
+      env: { ...process.env, ATOOL_ROOT: ROOT_DIR },
+    });
+  }
+}
+
+// ── CLI Argument Parsing ─────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const command = args[0] || 'help';
+  const flags = args.slice(1);
+
+  return { command, flags };
+}
+
+function hasFlag(flags, name) {
+  return flags.includes(`--${name}`) || flags.includes(`-${name}`);
+}
+
+// ── Command Handlers ─────────────────────────────────────────────────────────
+
+function cmdInstall(flags) {
+  const installArgs = [];
+
+  if (hasFlag(flags, 'all')) {
+    installArgs.push('--all');
+  }
+  if (hasFlag(flags, 'yes') || hasFlag(flags, 'y')) {
+    installArgs.push('--yes');
+  }
+  if (hasFlag(flags, 'claude')) {
+    installArgs.push('--claude');
+  }
+  if (hasFlag(flags, 'cursor')) {
+    installArgs.push('--cursor');
+  }
+  if (hasFlag(flags, 'kiro')) {
+    installArgs.push('--kiro');
+  }
+  if (hasFlag(flags, 'dry-run')) {
+    installArgs.push('--dry-run');
+  }
+  if (hasFlag(flags, 'force')) {
+    installArgs.push('--force');
+  }
+
+  // Pass through --project and --analyze with their values
+  const flagsList = flags.join(' ');
+  const projectMatch = flagsList.match(/--project\s+(\S+)/);
+  if (projectMatch) {
+    installArgs.push('--project', projectMatch[1]);
+  }
+  const analyzeMatch = flagsList.match(/--analyze\s+(\S+)/);
+  if (analyzeMatch) {
+    installArgs.push('--analyze', analyzeMatch[1]);
+  }
+
+  if (installArgs.length === 0) {
+    installArgs.push('--all');
+  }
+
+  runInstallSh(installArgs);
+}
+
+function cmdUpdate(flags) {
+  const updateArgs = ['--update'];
+  if (hasFlag(flags, 'yes') || hasFlag(flags, 'y')) {
+    updateArgs.push('--yes');
+  }
+  runInstallSh(updateArgs);
+}
+
+function cmdCheckUpdates() {
+  const installedVersion = readVersion();
+  const output = {
+    installedVersion,
+    packageVersion: require(path.join(ROOT_DIR, 'package.json')).version,
+    platform: process.platform,
+    arch: process.arch,
+  };
+
+  console.log(JSON.stringify(output, null, 2));
+}
+
+function cmdVersion() {
+  const version = readVersion();
+  console.log(`aTool v${version}`);
+}
+
+function cmdHelp() {
+  const version = readVersion();
+  console.log(`aTool - AI Developer Toolkit v${version}`);
+  console.log('');
+  console.log('Usage:');
+  console.log('  atool install [--all] [--yes] [--claude] [--cursor] [--kiro]');
+  console.log('  atool update [--yes]');
+  console.log('  atool check-updates');
+  console.log('  atool version');
+  console.log('  atool help');
+  console.log('');
+  console.log('Commands:');
+  console.log('  install         Install aTool to detected AI IDEs (default: --all)');
+  console.log('  update          Update aTool to the latest version');
+  console.log('  check-updates   Check installed version info (JSON output)');
+  console.log('  version         Show current version');
+  console.log('  help            Show this help message');
+  console.log('');
+  console.log('Options:');
+  console.log('  --all           Install to all detected IDEs');
+  console.log('  --claude        Install to Claude Code CLI only');
+  console.log('  --cursor        Install to Cursor only');
+  console.log('  --kiro          Install to Kiro only');
+  console.log('  --yes, -y       Skip confirmation prompts');
+  console.log('  --dry-run       Preview mode — no changes made');
+  console.log('  --force         Overwrite existing configs');
+  console.log('  --project PATH  Initialize a project');
+  console.log('  --analyze PATH  Prepare project for deep analysis');
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+function main() {
+  const { command, flags } = parseArgs(process.argv);
+
+  switch (command) {
+    case 'install':
+    case 'i':
+      cmdInstall(flags);
+      break;
+    case 'update':
+    case 'u':
+      cmdUpdate(flags);
+      break;
+    case 'check-updates':
+    case 'check':
+      cmdCheckUpdates();
+      break;
+    case 'version':
+    case '-v':
+    case '--version':
+      cmdVersion();
+      break;
+    case 'help':
+    case '-h':
+    case '--help':
+    default:
+      cmdHelp();
+      break;
+  }
+}
+
+main();

package/bin/postinstall.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+// @ts-check
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+const ROOT_DIR = path.resolve(__dirname, '..');
+const VERSION_FILE = path.join(ROOT_DIR, 'VERSION');
+
+function readVersion() {
+  try {
+    return fs.readFileSync(VERSION_FILE, 'utf8').trim();
+  } catch {
+    return 'unknown';
+  }
+}
+
+const version = readVersion();
+console.log(`aTool installed successfully (v${version})`);
+console.log('');
+console.log('Run "atool install --all --yes" to configure your AI IDEs.');
+console.log('Or open aTool Monitor to get started with the GUI.');