SuperAPI AI 工具集

architecture audit

写作与研究

查看项目

更新于 10-15 21:40

技能介绍

用途:对项目进行系统性一致性审计,确保代码、文档、图表和配置等各类产物保持同步。触发词包括 audit、comprehensive review、fact-check、consistency check、project health、pre-release audit、documentation review,适合在重大发布前或大规模重构后使用。

主要能力:检查版本一致性(各文件中的版本号是否与规范版本一致);术语一致性(维护废弃术语表并搜索旧术语);事实清单核对(技能、命令、工具、代理、指令、提示等数量与文档描述是否一致);图表校验(Mermaid/ASCII 图的节点标签、计数、流向、分组名是否准确);交叉引用验证(内部链接、锚点、图片、导入语句是否有效);代码与文档同步(导出函数、配置项、CLI 命令、错误信息是否被文档覆盖);配置对齐(TypeScript 常量、JSON schema、环境变量、功能开关是否被记录)。

使用方式:按清单逐项执行,可借助 PowerShell 命令搜索版本模式、废弃术语、图表和 Markdown 链接;输出审计报告模板,包含日期、版本、审计人、各分类状态与问题数、问题详情及修复建议、已采取行动。可集成到 pre-commit 钩子、CI 流水线(如 GitHub Actions 在 PR 时运行 npm run audit:full)或定时任务(如每周一 9 点)。

限制与注意:该技能审计用户项目代码,不审计 .github/ 中的 Alex 认知架构,执行时应忽略 .github/ 目录内容。资料未提供具体安装命令、收费信息或平台支持范围。反模式包括发布前跳过审计、仅手动审计、修复不记录、忽视表面问题、只审计变更文件;最佳实践包括发布前完整审计、迁移时更新废弃术语、结构变更后更新事实清单、记录发现、自动化重复检查、为人工审查设定时间盒。