用途:doc-brd 用于在项目或新功能启动时编写商业需求文档(BRD),即 SDD 流程的第 1 层入口,不依赖上游产物。它以业务语言记录业务目标、干系人、范围与成功标准,供下游 PRD → EARS → BDD → ADR → SPEC → TDD → IPLAN → Code 使用。
主要能力:先判定 BRD 类型——平台型(定义基础设施、技术栈或横切关注点,文件名为 BRD-NN_platform_{slug})或功能型(描述单一用户工作流,文件名为 BRD-NN_{feature_slug})。模板要求 16 个章节,包括文档控制、引言、业务目标、项目范围、干系人、功能需求、架构决策主题、质量期望、约束与假设、验收标准、业务风险管理、审批、可追溯性、术语表等,另含图表注册表与生命周期附录。第 8 节须覆盖基础设施、数据架构、集成、安全、可观测性、AI/ML、技术选型 7 类架构决策主题,但不引用 ADR 编号。单个 BRD 最多承载 5 条功能需求,超出则新建 BRD-02。
使用方式:先读取模板 BRD-TEMPLATE.yaml、层 README、ID 命名标准与写作风格文档;确认无 ID 冲突(ls docs/01_BRD/)。每个 BRD 放在 docs/01_BRD/BRD-NN_{slug}/ 嵌套目录中,超过 25 KB 时按章节拆分。元素 ID 通过 python -m sdd_doc_lint.rehash --compute --doc-id NN --section-id SS --title T --description D 生成。完成后更新 BRD-00_index.md 并一起提交。若由 saga 驱动的 autopilot 调用且简报含 Draft,则派发一个 subagent_type=aidoc-flow:requirements-analyst 的 Task 子代理撰写。
适用场景:新项目或新功能的业务需求定义、战略对齐与市场背景记录、成功标准文档化,以及将实施计划回译为业务语言需求。
限制:本技能是校验器而非运行时代码;结构检查为确定性底线,内容质量由 doc-brd-audit 评审。质量门禁要求 PRD-Ready 分数 ≥ 90/100。错误码 XDOC-006、XDOC-008、XDOC-009 均为 error 级。BRD-REF 文档为自由格式,豁免评分与质量门禁。具体收费、价格与平台信息暂未提供。