SuperAPI AI 工具集

ingest-codebase

测试与质量

查看项目

更新于 10-16 06:47

技能介绍

用途:为代码库创建高质量心智模型,捕捉系统实际运作方式,包括概念边界、职责、决策与连接,而不仅是文件清单。适用于新建模型、模型不完整或过浅、理解系统架构、重大变更后校验模型准确性。

主要能力:以领域(名词)、能力(动词,需 --operates-on 连接领域)、横切关注点(需 --applies-to)、架构决策(--why)四类实体组织模型;强调无孤立实体,能力必须连接领域,关注点必须连接作用对象。

使用方式:分阶段推进。阶段1 并行启动 5-10 个代理快速调研 README、目录、配置、导出、测试、入口、数据模型与外部集成;阶段2 对每个子系统启动 10-20 个代理深挖领域概念、能力、依赖、被依赖、决策与关键文件;阶段3 用 mental CLI 建实体,如 mental add domain <Name> --desc "..." --files "..."、mental add capability <Name> --desc "..." --files "..." --operates-on "Dom1,Dom2"、mental add aspect <Name> --desc "..." --files "..." --applies-to "Cap1,Dom2"、mental add decision "<What>" --why "...";用 mental update capability <Name> --operates-on "..." 修正连接;用 mental show 查看、mental view 浏览器可视化、mental delete 删除。阶段4 启动 5-10 个校验代理找缺口;阶段5 迭代补齐。

适用场景与规模:小型(<50k LOC)约 4-8 领域、10-20 能力、3-5 关注点、3-5 决策、10-15 代理;中型 8-15 领域、20-40 能力、5-10 关注点、5-10 决策、20-30 代理;大型 12-20 领域、30-60 能力、8-15 关注点、10-20 决策、30-50 代理。

限制与注意:避免把 Utils、Helpers、Services、Controllers、Repositories 等代码组织当作领域;避免过浅建模;必须运行校验并迭代 2-3 轮。资料未提供该技能的收费、价格、平台支持与效果数据。