SuperAPI AI 工具集

spec-writer

办公与效率

查看项目

更新于 10-15 21:42

技能介绍

用途:该技能以专家引导的交互访谈方式,帮助用户为全新(greenfield)项目创建分层软件规格文档,覆盖从“为什么做”到“如何验证”的五个层级。

主要能力与命令:/spec-vision 产出产品愿景与战略对齐(L0);/spec-brs 产出业务与干系人需求规格(L1);/spec-srs 产出软件需求规格(L2);/spec-architecture 产出架构与设计规格(L3);/spec-test 产出行为规格与测试验证计划(L4);/spec 依次走查全部五份文档。每份文档要求包含元数据头、可追溯 ID(如 G-1、BR-001、REQ-FUNC-001)、MoSCoW 优先级与适配准则;需求须可度量(如 p99 ≤ 200ms、99.9% 月度可用性),NFR 模糊表述会被要求量化,BRS 保持与实现无关。

使用方式:调用任一命令时,先阅读 references 目录下对应参考文件(vision.md、brs.md、srs.md、architecture.md、verification.md),再检查是否已有上层文档并提取上下文;随后以选题加自由输入选项的方式每轮提问 1–3 个,按节确认后再推进。输出为 Markdown 文件,保存至 /mnt/user-data/outputs/,命名如 {project-name}-{document-type}.md。

适用场景:B2B SaaS、B2C 应用、内部工具、平台与 API 等新建项目,可按团队规模与合规背景(医疗、金融、政府等)调整文档深度与建议。

限制:资料未说明具体收费、价格或平台支持情况;文档质量依赖用户提供的信息完整度,未知项应记入 TBD 日志而非省略。