内容
<div align="center">
# AIDA
### AI 工具资产治理层 — 规则、技能、决策记忆、插件
[](./package.json)
[](./LICENSE)
[](https://nodejs.org)
[](#验证)
[](https://glama.ai/mcp/servers/LWTlong/aida)
</div>
---
## 三大能力
### 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
```
