用途:面向已有代码库的接入场景。当用户导入现有项目、希望在老项目中使用 feature-workflow,且项目缺少 specs/ 目录时,该技能扮演“项目考古学家”与文档工程师,通过扫描代码库逆向生成全套全局指引文档。
主要能力:一是侦查分析,读取 README.md 获取产品背景,读取 package.json、go.mod、requirements.txt、pom.xml、Cargo.toml 等依赖文件识别技术栈,扫描根目录及 src/ 一级子目录了解结构,检查 .eslintrc*、.prettierrc*、tsconfig.json 等配置了解开发规范。二是文档生成,产出 specs/1_产品概述.md(基于 README,信息不足则填“待补充”)、specs/2_技术栈.md(识别前端 React/Vue/Next.js/Tailwind、后端 Express/NestJS/Gin/Django/Spring Boot、数据库驱动及 TypeScript/Jest/Docker 等工具)、specs/3_项目结构.md(列出目录树并附简短说明)、specs/4_开发规范.md(有 ESLint/Prettier 则记录,否则建议通用社区规范)。
使用方式:先执行侦查,再向用户展示检测报告(项目类型、核心目录、已有文档等),确认后写入 specs/ 目录。需遵守 specs/GUARDRAILS.md 通用边界守卫规则,当前处于需求与分析阶段。
适用场景:存量项目接入、为老项目补齐 AI 工作流所需的全局指引文档。
限制:AI 无法完全推测业务愿景,生成后建议用户手动检查 1_产品概述.md;README 信息过少时只能生成模板并标注待补充。具体安装命令与调用方式资料未提供。