LWTlong/ai-dev-analytics
📇 🏠 - An open-source observability layer for AI coding. Silently tracks dev tokens/time and auto-codifies AI deviations into persistent project rules.
Quick Install
{
"mcpServers": {
"lwtlong-ai-dev-analytics": {
"command": "npx",
"args": [
"-y",
"lwtlong-ai-dev-analytics"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
三大能力
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 加入:
{ "mcpServers": { "aida": { "command": "npx", "args": ["-y", "aida", "mcp"] } } }
或用一键脚本:
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 |
项目结构
.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
验证
npm test
npm run build