# AIDA ### AI 工具资产治理层 — 规则、技能、决策记忆、插件 [![version](https://img.shields.io/badge/version-3.0.1-0066ff)](./package.json) [![license](https://img.shields.io/github/license/LWTlong/aida?color=%23333)](./LICENSE) [![node](https://img.shields.io/badge/node-%3E%3D18-339933)](https://nodejs.org) [![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#验证) [![aida MCP server](https://glama.ai/mcp/servers/LWTlong/aida/badges/score.svg)](https://glama.ai/mcp/servers/LWTlong/aida)

--- ## 三大能力 ### 1. 资产治理扫描 `.claude/rules/`、`.cursor/rules/`、`.codex/`、`.aida/` 等目录，找出重复、矛盾、失效的规则和技能。所有写操作走 `aida_apply_governance` MCP 工具，每批 journal 一次，可通过 `aida_undo` 一键回滚。 **核心 skill：** `/aida-govern`（一站式） ### 2. 分层决策记忆用 MADR 格式把 "为什么这段代码这么写" 记录到 `.claude/rules/decisions/`。Claude Code 通过 `paths` 前置元数据在相关文件打开时自动加载，无需手动召回。 **核心 skill：** `/aida-remember`、`/aida-remember-branch` ### 3. AI 资产总览本地 Dashboard（`aida dashboard`）提供 package.json 风格的资产清单：规则/技能/决策/MCP 配置/插件，一屏看完。 **核心 skill：** `/aida-audit` --- ## 30 秒上手（Claude Code Plugin） ``` /plugin marketplace add LWTlong/aida /plugin install aida@aida ``` 重启 Claude Code。12 个 `aida-*` skill 会立刻可用。 **升级：** ``` /plugin update aida ``` ### Cursor / Codex / VS Code（可选，走 MCP）在项目根 `.mcp.json` 加入： ```json { "mcpServers": { "aida": { "command": "npx", "args": ["-y", "aida", "mcp"] } } } ``` 或用一键脚本： ```bash npx aida init ``` --- ## Skill 一览 | 类别 | Skill | 用途 | |---|---|---| | **治理** | `/aida-govern` | 一站式：扫描 → 分析 → 确认 → 一次落盘（覆盖规则过载/任务型规则/文档冗余/跨工具重复/冲突/聚合镜像/2.x 遗留物） | | | `/aida-resolve` | 解决 AI 资产文件的 git 合并冲突 | | | `/aida-sync` | 跨工具同步：Claude ↔ Cursor ↔ Codex（你选源→目标） | | | `/aida-import` | 从本地目录路径安全导入外部 Claude Plugin（先审计风险） | | **只读** | `/aida-audit` | 扫描并梳理项目所有 AI 资产 | | **记忆** | `/aida-remember` | 记一条决策为 MADR，Claude Code 自动加载 | | | `/aida-remember-branch` | 从当前分支的 diff 批量提取决策 | | | `/aida-recall` | 召回之前沉淀的模块记忆 | | | `/aida-analyze` | 分支/功能开发完后沉淀"改了什么、为什么" | | | `/aida-undo` | 回滚最近一次 AIDA 写操作 | | **分享** | `/aida-pkg` | 打包资产为 Claude Plugin | | | `/aida-ui` | 打开本地 Dashboard（检查 npm 包 → 引导安装 → 给出启动命令）| | | `/aida-help` | 显示 skill 参考卡片 | --- ## MCP 工具清单 | 工具 | 作用 | |------|------| | `aida_bootstrap` | 初始化 / 状态检查 / 工具授权清单 | | `aida_scan_assets` | 扫描所有 AI 资产 | | `aida_list_assets` / `aida_get_asset` | 浏览资产 | | `aida_apply_governance` | 执行治理动作（create/modify/delete/remove-lines），全部 journaled | | `aida_undo` | 撤销上一次治理操作 | | `aida_write_analysis` | 写分析报告 | | `aida_memory` / `aida_remember` / `aida_recall` | 读写决策记忆 | | `aida_build_plugin` | 打包项目资产为 Claude Plugin | | `aida_build_self_plugin` | 打包 AIDA 自身为 Plugin | | `aida_parse_plugin` / `aida_audit_plugin_risk` | 解析/审计外部 Plugin | --- ## 项目结构 ```text .claude-plugin/ plugin.json # Claude Plugin 清单（本仓库本身就是 plugin） marketplace.json # Marketplace 清单 src/ assets/skills/ # 12 个 aida-* skill 源（plugin skills 字段指过来） core/ # 扫描、治理、undo、memory、plugin builder mcp/server.ts # MCP server cli/ # aida CLI dashboard/ # Dashboard 前端产物 .claude/ rules/decisions/ # MADR 决策记忆（Claude Code 自动加载） .aida/ cache/ # 扫描结果 + undo journal ``` --- ## 验证 ```bash npm test npm run build ```