用途:从现有代码库中逆向提取可实施的工程规格,使他人仅凭文档即可复刻项目,而非套用模板填空。
主要能力:以“解构思维”为核心,对每段代码、结构或行为提出 7 个问题:是什么、为何存在、如何工作、输入、输出、依赖关系、可能出错之处。提供可复用流程:项目发现、结构分解、深度提取、横切关注点、测试规格、验证与校验;产出含项目概述、架构、术语表、配置、数据实体、API、业务逻辑、集成、测试规格和可复现性验证的分层文档结构。
必要用法:需 bash(支持 macOS 默认 Bash 3.2)及 find、grep、sed、wc、date 等标准 Unix 工具,可选 rg 加速大仓库扫描。资料给出脚本调用示例:bash scripts/discover_project.sh <project_root>、bash scripts/inventory_elements.sh <project_root> <output_file>、bash scripts/verify_coverage.sh <project_root> <spec_output>、bash scripts/verify_implementation.sh <spec_output> <project_root>。规格中建议添加 Source: 行以支持规格到代码的核对。
适用场景:需要实施级规格(迁移、重写、入职、供应商交接);希望把代码中的隐式规则显式化;需要可重复的清单、规格骨架与验证工作流。
限制:不适合仅需架构概览或轻量 README 更新;也不是安全审计、性能剖析或代码风格清理工具;仓库含高度敏感数据且无法安全存储含路径的报告时不应使用。具体版本、许可证及脚本实现细节资料未提供。