SuperAPI AI 工具集

module-spec-generator

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:为模块生成规格文档,遵循 amplihack 的砖块哲学(Brick 为单一职责的自包含模块,Stud 为对外公共契约),使模块可依据规格独立重建而不破坏连接点。适用于新建模块前明确需求、为现有代码补文档、模块审查、重构决策与知识保存。

主要能力:分析模块代码,提取公共接口(函数签名、类与数据模型、常量)、依赖(标准库、外部包、内部模块)、模块结构、测试要求,并生成含示例用法的规格文档,保存到 Specs/[module-name].md。

使用方式:按步骤分析——阅读模块文件、识别单一核心职责、提取 all 等导出项、映射依赖、分析文件组织、确定测试要求,最后生成规格。可让 Claude 访谈需求、分析相似模块、生成规格,或分析现有目录提取规格,或比对规格与实现报告差异。

限制:资料未提供具体安装命令、收费与平台信息;规格质量依赖代码可分析性,需避免过度指定实现细节、契约含糊与依赖不清。