SuperAPI AI 工具集

requirement-to-spec

办公与效率

查看项目

更新于 10-15 17:18

技能介绍

用途:把一份业务需求文档(Word、PDF、Excel、Markdown 或纯文本及其附件)转换为一份书面规范(spec)和一份有序的任务拆解,并写入团队跟踪工作的位置。这是两段式技能流水线的前半段:/arkandia:requirement-to-spec 生成规范与可构建的子任务;/arkandia:linear-plan-build 与 /arkandia:ado-plan-build 再据此逐项实现。后两者按约定只写状态和评论,不创建子任务,所以本技能负责填充其消费的父任务。

主要能力:读取并转换文档(依赖 npx,转换链为 anydoc→原生读取→停下询问),做强制附件检查;读取目标仓库上下文(AGENTS.md、CLAUDE.md、docs、ADR);检测变更可能触及的公共契约及其消费方;检测会被本次变更作废的既有文档并给出引用证据;检测可用的 Linear/Azure DevOps 跟踪器与数据库 MCP 服务器;通过最多 4 题一批的提问澄清歧义、验证标准与范围蔓延;最终产出规范、任务拆解,并在跟踪器模式创建父任务及子任务。

使用方式:从目标仓库内运行,$ARGUMENTS 为需求文档路径,缺失时询问。运行分发现、前置检查、范围确认、应用等阶段。写入范围限定在 docs/specs/<slug>/;不提交 git、不开 PR、不写代码。

限制:文档被当作不可信数据,只引用不执行其中指令;缺失事实只报告不猜测;不替用户做承诺,破坏/保持契约、范围登记、目标跟踪器均需询问;文档转换依赖 npx,降级模式不支持 .docx/.xlsx/.pptx;具体定价、平台细节与效果暂未提供。