SuperAPI AI 工具集

spec-gathering

办公与效率

查看项目

更新于 10-16 07:25

技能介绍

用途:在开始新功能、任务或项目,或任务描述含糊时,通过结构化提问收集用户需求,产出经用户确认的需求文档;不适合复现步骤清晰的简单缺陷修复、范围明确的单文件改动,或用户已提供完整需求的情况。

主要能力:按阶段加载项目上下文(如读取 .claude/context/product.md、tech-stack.md),确认任务描述,判定工作流类型(feature、refactor、investigation、migration、simple),识别受影响服务与范围;在阶段4.5调用 context-compressor(progressive disclosure 模式,ECLAIR),把澄清问题限定为3至5个并按 CRITICAL、HIGH、MEDIUM、LOW 排序,未提问项以 [ASSUMES: X] 记录默认假设;随后汇总并等待用户确认,再把需求映射为模板 token,包含 FEATURE_NAME、VERSION、AUTHOR、DATE、STATUS、ACCEPTANCE_CRITERIA_1/2/3、ASSUMPTIONS_MADE 等,调用 template-renderer 生成规格文件,默认输出到 .claude/context/artifacts/specifications/[feature-name]-spec.md,并校验无未解析 token、YAML frontmatter 有效。

使用方式:按阶段推进,先确认任务,再确认工作流类型与影响范围,提问后记录答案与假设,最后让用户确认;确认后才渲染规格。可用命令包括 cat .claude/context/product.md 2>/dev/null || echo "No product context" 以及 outputPath 示例 .claude/context/artifacts/specifications/${featureNameSlug}-spec.md。

限制与原则:不得在需求未确认前编写规格;不接受含糊的成功标准,要求可度量、可测试;需明确记录范围外内容与边界情况;澄清问题超过5个时应提示需求可能不完整。具体收费、价格、平台支持等信息暂未提供。