用途:当被调用时,为当前仓库/项目生成一份完整的软件规格说明文档,包含架构与技术选型、数据模型、关键流程、伪代码、系统上下文图、容器/部署概览、模块关系图(后端/前端)、时序图、ER 图、类图(关键后端类)、流程图和状态图。默认输出文件为 docs/specification.md;若 docs/ 不存在则创建,用户可指定其他路径。
主要能力:先进行仓库侦察,识别仓库根目录与结构(README*、docs/、architecture/、ADR*、design*、SPEC*),检测技术栈与运行时(如 pyproject.toml、requirements.txt、go.mod、pom.xml、build.gradle、.csproj、package.json、Dockerfile;前端信号如 vite.config.、next.config.),检测数据层(migrations/、prisma/schema.prisma、alembic/、db/schema.sql、knexfile.、models/、entities/、schema/)与部署方式(docker-compose.yml、Dockerfile、k8s/、helm/、.github/workflows/*、terraform/),并收集证据指针(文件路径与简要说明)。
使用方式:调用后按固定模板输出一份 Markdown 文档,包含 12 个必需章节,所有图表使用 ```mermaid 围栏代码块。遵循最小提问策略:仅当仓库信息不足以免不安全猜测时,最多提 5 个澄清问题;信息缺失时进行尽力推断,并在顶部附近添加“Assumptions & Open Questions”章节。禁止编造细节,无法在仓库中找到证据的内容标注为 Assumption、Unknown/TBD 或 Open question。
适用场景:需要为现有代码库快速产出结构化规格说明、架构文档或设计文档时。
限制:仅依据仓库中可找到的证据;缺失信息需明确标注,不虚构功能、收费、平台或效果。具体命令与安装方式资料中暂未提供。