SuperAPI AI 工具集

scribe

通用与其它

查看项目

更新于 10-16 01:50

技能介绍

Scribe 是面向独立正式文档与跨团队统一规格包的“权威规格撰写者”,把证据、想法与决策转换为可追溯、可实现的单一事实来源,不写代码、不做架构决策。

用途:需要输出 PRD、SRS、HLD、LLD、实现/评审/发布清单、测试规格或验收标准、追溯矩阵与变更日志、评审就绪文档包、面向 AI 智能体消费的规格、跨团队共享需求包、分层 L0-L4 细化、Full/Standard/Lite 范围选择、Spec-Kit 兼容的可执行规格、用户故事地图与利益相关者映射及责任矩阵时使用。

主要能力:按文档类型选用标准化模板;按 _common/TRACEABILITY.md 规范分配需求 ID,SRS 与持久规格额外输出 .traceability.yaml 账本,兼容读取旧式 FR-/NFR-;要求每条需求可二进制通过/失败测试,把“快、安全、易用”替换为可测阈值;要求术语表、Given-When-Then 验收标准、范围/非目标/成功指标/依赖/变更历史、评审与批准字段;依 ISO/IEC/IEEE 29148:2018 质量属性校验;MVP 范围 SRS 目标 8-12 页、句子不超过 20 词;作为受版本控制的活文档,与代码发布版本绑定并用 PR 评审;面向智能体的规格遵循 AGENTS.md 约定(命令、测试、项目结构、架构、安全、约定),不超过 150 行;跨团队包按 L0 愿景→L1 需求→L2 读者细节→L3 验收标准→L4 证明顺序细化,L3 经 Three Amigos/Example Mapping 定稿。

使用方式:工作流为 UNDERSTAND→STRUCTURE→DRAFT→REVIEW→FINALIZE→INSCRIBE;统一规格配方为 ALIGN→STRUCTURE→ELABORATE→BRIDGE→VERIFY→DELIVER→UNIFY。范围模式分 Full(12+ 需求)、Standard(4-11)、Lite(1-3);Must 超过 60% 时告警,要求 REQ 与 AC 双向链接。资料未提供安装命令或具体调用命令。

适用场景:游戏、SaaS、电商、仪表盘、营销等项目的规格撰写与交接。

限制:不写实现代码,不做架构或 API 设计决策,不做功能创意与优先级排序,不写代码注释或 JSDoc,不做视觉稿或线框。需求矛盾、文档类型不明、范围显著扩大、需合规确认、10+ 未分解需求等应先询问;不得虚构需求或使用含糊语言。