SuperAPI AI 工具集

agentic-progressive-disclosure-architecture

编程与开发

查看项目

更新于 10-15 21:37

技能介绍

用途:该技能用于构建适合智能体编程的代码库,让代码结构先揭示意图,只有加载更深层文件时才暴露实现细节。适合上下文窗口较小、需要保持专注的智能体密集型编程工作流,以及希望 API 形态可见而无需加载完整实现的大型系统。

主要能力:顶层文件主要是声明式内容,如简短说明、模块映射与 API 签名;重逻辑放在更深层的模块或文件中;高层模块通过再导出或转发保留易用的公共 API;递归应用同样的披露拆分,每一层都暴露意图与 API 形态并转发到子模块,直到叶子实现文件;每层可添加 AGENTS.md 描述该子树的上下文与约束,形成可导航的树。该模式在模块或包边界明确的 Rust 和 Go 中最强;Go 建议使用具体实现加高层转发,避免只有接口的顶层模式。

使用方式:资料给出 Rust 与 Go 的实现示例参考文件(references/rust-module-forwarding.md、references/go-package-forwarding.md),未提供安装命令或调用步骤。团队需熟悉 IDE/LSP 的跳转定义与符号搜索。该技能与命名、测试、错误处理等现有整洁代码实践正交。

适用场景与限制:适合智能体工作流与大型系统。限制是相关收益依赖明确的模块边界,弱类型或边界模糊的语言/项目收益较弱;基准测试与深度性能验证属于技能设计与推广评估,不属于核心使用说明。建议的检查是测试断言调用方只依赖顶层 API 或再导出,且调用方无需导入叶子实现模块;资料未说明具体平台、收费或效果数据。