用途:INSPEKTERA 用于代码库健康审计,是多维结构质量评估,输出基于证据的发现、置信度评分与趋势追踪,回答“代码库是在变好还是只是变大”。每次调用等于一次审计,发现结果通过 TODO.md 反馈给 realisera 的工作选择。
主要能力:提供架构对齐、模式一致性、耦合健康、复杂度热点、测试健康、依赖健康、版本健康、产物新鲜度、安全卫生等维度;每条发现包含位置(file:line)、证据、影响、建议动作与 0-100 置信度,并给出 A-F 维度评级与相对上次审计的趋势。
使用方式:状态产物为 .agentera/ 下的 HEALTH.md,缺失时引导创建。读取产物前先检查 .agentera/DOCS.md 是否存在 Artifact Mapping;无映射时默认 VISION.md、TODO.md、CHANGELOG.md 在项目根目录,其余在 .agentera/。开始前需阅读 references/contract.md 获取 token 预算、严重级别与格式约定。流程分六步:orient、select、assess、distill、report、connect。第一步并行读取 HEALTH.md、TODO.md、PROGRESS.md,并读取 VISION.md、DECISIONS.md;可运行 python3 scripts/effective_profile.py 校准健康标准;随后做项目发现与 git log --oneline -20。若自上次 HEALTH.md 更新以来 git diff 无文件变化,则报告 complete: no changes since last audit 并停止。第二步按代码库与用户请求选择维度,用户指定则只审计指定维度。第三步按维度并行代理评估,先跑 references/audit-commands.md 快速清单。
适用场景:需要定期评估代码库结构质量、追踪健康趋势、为后续工作挑选优先项的项目;有测试、外部依赖、多模块或已记录架构的项目更适用。
限制:安全卫生仅为基于正则的轻量扫描,不能替代专门安全工具;不报告 linter 或类型检查器可捕获的问题、TODO.md 已跟踪问题、DECISIONS.md 中记录的有意决策;版本健康仅在 DOCS.md 含版本约定块时运行;产物新鲜度在无计划上下文时降级为提示性信息。资料未提供收费、价格与平台信息。