CommunityPesquisa e Análise de Dadosgithub.com

skills-summarize-audit — 审计技能

Auditoria universal de ferramentas de agente — perfil, pontuação, otimização / 技能审查·画像·评分·优化

O que é skills-summarize-audit — 审计技能?

O skills-summarize-audit é uma skill de agente de IA que realiza auditorias completas do repositório de skills do agente ou do projeto atual. Ela gera um perfil multidimensional do projeto, uma pontuação de sete dimensões (S/A/B/C/D), análise de capacidade e recomendações de otimização, produzindo um relatório de auditoria acionável. A skill ajuda a identificar a saúde do repositório de skills, detectar skills zumbis e redundâncias, calcular a capacidade efetiva restante com alertas, e fornece uma lista de operações executáveis (arquivamento, instalação, atualização) com suporte a rollback via `--undo`. Pode ser integrada a pipelines CI/CD com saída JSON e lógica de porta. Suporta múltiplas plataformas (Codex, Claude, Cursor, Coze) e inclui detecção de atividade de skills, sinais externos (GitHub stars, npm downloads) e um mecanismo de recomendação baseado em complementaridade de capacidades.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add gtbwpkwjnb-alt/skills-summarize-audit-skill

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skills-Summarize-Audit — 技能库与项目画像驱动审计(联动 summarize)

对技能库或当前项目做多维画像、七维评分、容量分析与优化推荐,最终输出可执行的审计报告。

它能帮你:

  • 了解技能库健康度(🟢/🟡/🔴)和变化趋势(📈 ↑/↓)
  • 发现僵尸技能和冗余重叠
  • 计算 Agent 还能装多少技能(多因子有效容量预警)
  • 获得可执行的归档/安装/更新操作清单
  • 误操作后可一键回滚(--undo)
  • 集成到 CI/CD 流水线(JSON 输出 + 门禁逻辑)

触发词 / Palavras de Ativação

本技能采用独立词触发:触发词必须独立发送(可带子命令),句中不触发。与 summarize 技能联动设计,技能总结 可直接触发审计。

  • 技能审计:技能审查、技能审计、技能检查、能力审查、能力审计、工具审查、技能总结、skills-audit、skill-audit、skill-check、capability-audit、tool-audit、skills-summarize-audit
  • 项目审计:项目审查、项目审计、项目诊断、项目画像、环境审查、环境审计、project-audit、project-check、project-diagnosis、project-profile、env-audit
  • 回滚操作:回滚、撤销、恢复、undo-snapshot、rollback、revert
  • 子命令:深度/deep、推荐/recommend、画像/profile、健康/health、轻量/quick、ci/--ci、回滚/undo/--undo

触发词矩阵

模式中文触发词英文触发词
技能审计技能审查, 技能审计, 技能检查, 能力审查, 能力审计, 工具审查, 技能总结skills-audit, skill-audit, skill-check, capability-audit, tool-audit, skills-summarize-audit
项目审计项目审查, 项目审计, 项目诊断, 项目画像, 环境审查, 环境审计project-audit, project-check, project-diagnosis, project-profile, env-audit
回滚操作回滚, 撤销, 恢复undo-snapshot, rollback, revert

同义字词:审查=审计=检查=诊断、能力=技能=工具、环境=项目 → 自动归入对应模式。

触发行为

会触发 ✅不会触发 ❌
技能审查(独立发送)帮我做一次技能审查(句中)
skills-audit skills-summarize-audit(独立发送)run skills-audit on this(句中)
技能总结(独立发送,联动 summarize 品牌)总结一下技能(句中不触发)
技能审计 深度(独立词+子命令)这个项目需要能力审查吗(句中)

语言自适应:用户主语言为英文时(会话中英文>70%),触发词匹配优先英文,报告输出语言切换为 en。


何时使用 / Quando Usar

  • 技能审计模式:定期维护技能库健康度(建议每2-4周一次),或技能库较大变更后。可与 总结 联动:run summarize → 发现技能堆积 → 建议 技能总结
  • 项目审计模式:接手新项目时快速了解技术栈和工具链,或项目重构前评估环境健康度
  • 触发词翻译精炼:自动将技能 description 翻译为中文触发词+简介(或反向),方便跨语言用户快速了解技能功能

前置条件 / Pré-requisitos

硬性要求(缺失时自动检测 + 安装引导)

  • codegraph — 代码结构与符号查询,技能核心分析引擎。缺失时尝试自动安装。
  • git — 版本对比、快照与回滚。缺失时尝试自动安装。
  • config.yaml — 本技能目录下的唯一配置源。缺失时从模板生成。

软性要求(缺失时自动创建)

  • user-profile.md — 用户画像。缺失时自动通过问答引导创建。

能力清单 / Capacidades

skills-summarize-audit 提供以下核心能力(v6.0.0 新增能力矩阵+质量信号+社区Feed+生态雷达):

  • 项目技术栈画像与项目类型识别
  • 技能库全量扫描与增量清单
  • 能力维度矩阵构建(~12 能力维度,v6.0.0)
  • 质量信号读取(联动 summarize 错误账本,v6.0.0)
  • 多因子有效容量分析与容量预警
  • 6 项技能活性检测
  • 七维 S/A/B/C/D 评分与强制理由
  • T3 活性验证与误归档风险控制
  • 社区 Feed 搜索(能力缺口驱动的 GitHub 搜索,v6.0.0)
  • 基于能力互补性的工具推荐(替代/互补/补充/无关,v6.0.0)
  • 生态雷达区块(条件输出,有问题才显示,v6.0.0)
  • 逐技能深度阅读与外部来源验证
  • 外部信号缓存与三层推荐引擎
  • 30 秒摘要报告与趋势对比
  • 快照备份与 --undo 回滚
  • CI/CD 无交互模式与 JSON 门禁输出
  • 触发词翻译精炼与描述质量检查

按执行阶段排列的详细能力表:

阶段能力说明
⓪ 配置多平台自适应Codex/Claude/Cursor/Coze 平台自动检测
① 画像项目技术栈扫描自动识别 15+ 项目类型(Web/Rust/Python/Go/Java...)
② 清单技能库全量扫描 + 能力映射扫描 4 个路径 + capability-dimensions.yaml 映射(v6.0.0)
②-bis容量分析多因子有效容量计算(token + 冲突因子 + 认知容量)
②-ter活性检测6 项检查验证技能是否可用(Agent可达性/MCP/命令/触发/数据/使用证据)
④ 评分七维评分 + 质量信号7维评分 + 读取 summarize 错误账本(v6.0.0)
④-aT3 活性验证归档前核实使用证据/修改时间/触发记录,降低误归档率
④-bis深度阅读S/A 全量深读、B(画像相关)全量、B(非相关)精简
⑤a外部信号GitHub⭐/npm📥 缓存采集
⑤-aa社区 Feed能力缺口驱动的 GitHub 搜索(v6.0.0)
⑤b能力矩阵推荐引擎基于能力互补性的推荐(替代/互补/补充/无关,v6.0.0)
⑥报告生成 + 生态雷达30 秒摘要 + 容量块 + 评分表 + 条件生态雷达区块(v6.0.0)
⑦-a快照备份执行前自动备份所有 editable 技能
⑦-d操作回滚--undo 撤销任意执行操作,保留 7 天快照
CI无交互审计JSON 输出 + health/T3/actions 三门禁,集成 GitHub Actions

何时不使用 / Quando NÃO Usar

  • 单次文件编辑、实时调试、极简项目(无技能依赖)、仅需安装单技能
  • 低资源环境(审计消耗约5K-15K tokens/次)

执行流程

触发后,先读取 references/execution-flow.md 获取完整流程、评分表、容量计算、报告模板与 CI 规则。主文件仅保留入口与关键规则。

⓪前置配置 → ①项目画像 → ②技能清单+容量采集 → **②-ter活性检测**
→ ③加载参考数据 → ④分层评分
→ ④-bis深度阅读 → ⑤外部信号+推荐 → ⑥生成报告 → ⑥-bis审计验证 → ⑦执行 → ⑧持久化

关键规则

  • 画像:只扫描当前目录。从数据源提取痛点,禁止猜测。结果写入 {project}/.agents/project-profile.md
  • 分层:T1(命中核心活动)→ 保留;T2(通用)→ 保留;T3(专业)→ 建议归档
  • 评分:七维 S/A/B/C/D。每个技能附带 1 句理由;无理由 = 未评分
  • 容量:计算 Agent 可承载上限。可再装 ≤1 → 🔴,2-4 → 🟡,≥5 → 🟢
  • 外部信号:GitHub⭐缓存7天,npm📥缓存30天。网络不可用时跳过并标注,禁止伪造
  • 推荐:每项附带信心指数(0-10)+ROI。<7 时明确标注"评估中",<5 需有数据支撑才推荐
  • 执行:只修改用户层技能(editable=true)。系统技能只读。
  • 黄金法则:涉及技能开发/修改/推荐时,先搜索验证,引用 ≥2 独立来源
  • 活性检测:首次审计全量检测。后续仅检测新安装技能。深度 子命令强制全量。异常时触发单技能活检

输出示例

触发 技能审查 后,优先输出 30 秒摘要块:

🟢 技能库健康度:良好
🛠️ 关键操作:更新 1 个落后技能、归档 2 个 T3 技能
💰 预计节省:~3200 tokens/次(减少低价值 skill 注入)

随后输出评分表片段(示例):

技能综合FitValueFreshCommunityROINoveltyContamination建议
codegraphS5544555保留,核心工具
old-linterC2223224建议归档

完整报告格式见 references/report-template.md。


项目类型识别规则

核心推断规则(完整映射见 references/project-types.yaml):

  • package.json → Web/Node/全栈
  • Cargo.toml → Rust · pyproject.toml → Python · go.mod → Go
  • pom.xml/build.gradle → Java · .csproj → C# · pubspec.yaml → Flutter
  • CMakeLists.txt → C/C++ · Gemfile → Ruby
  • 多 SKILL.md + MEMORY.md → AI Agent 技能开发

边界规则(快速参考)

  • 触发:独立词触发,句中不触发
  • 分层:T1/T2/T3 以画像"核心活动"为唯一尺度
  • 评分:五档 S/A/B/C/D。附带强制理由,无理由=未评分
  • 深度分析:读全文正文。缺口须经工具验证。
  • 报告:有内容才输出。空区无兜底。
  • 推荐:附带信心指数 0-10 + ROI。<5 不推荐,需数据支撑。
  • 确认执行:操作需用户确认。系统技能只读。
  • 黄金法则:先搜索验证,≥2 来源。

平台配置与 CI/CD

支持平台:platforms/zcode.yaml · platforms/workbuddy.yaml · platforms/claude.yaml · platforms/codex.yaml · platforms/cursor.yaml · platforms/default.yaml。

CI 模式(技能审查 --ci 或 skills-summarize-audit --ci 或 skills-audit --ci):无交互、JSON 输出、跳过深度阅读,受 config.yaml 中 ci.max_tokens 预算限制。门禁逻辑:health=🔴 → exit_code=1 · actions_required>5 → exit_code=2 · T3_ratio>0.35 → exit_code=3。GitHub Actions 模板见 references/ci-github-actions.yml。

SkillSpector 安全扫描(可选):config.yaml → security_scan 启用后,扫描结果融入 Value 维度(Critical→D, High→C, 通过→+0.5档)。SkillSpector 为外部进程,不消耗 Agent Token。


文件结构

skills-summarize-audit/
├── SKILL.md                    # 技能主文件
├── VERSION                     # 版本号
├── LICENSE                     # MIT
├── README.md                   # 概览与安装
├── config.yaml                 # 审计配置
├── platforms/                  # 平台适配配置
├── references/                 # 参考文档
│   ├── execution-flow.md       # 执行流程索引
│   ├── flow/                   # 各阶段详细步骤(19 个子文件)
│   ├── project-types.yaml      # 项目类型映射
│   ├── skill-registry.yaml     # 技能注册表
│   ├── deep-analysis-template.md
│   ├── description-quality.md
│   ├── report-template.md
│   ├── ci-output-schema.md
│   ├── ci-github-actions.yml
│   └── recommendation-examples.md
├── tests/                      # 测试套件与验证脚本
├── .data/                      # 运行时数据(日志/缓存/统计/画像/外部信号)
├── install.ps1 / install.sh    # 安装脚本
└── CHANGELOG.md                # 变更日志

安装

一键安装与手动安装详见 references/installation.md(如不存在则参考 README.md)。

安装后输入 技能审查 或 技能总结 或 skills-summarize-audit 即可触发(skills-audit 仍受支持)。


反馈

🐛 GitHub Issues


Licença

MIT — ver LICENSE

Habilidades Relacionadas