用途:当交付物是面向构建者与运维人员的内部技术文档时使用,覆盖技术规格、PRD、架构文档、ADR/决策记录、运行手册与事件流程、发布/回滚/迁移指南、面向开发者的实现或维护指南。
不适用:对外发布的 API/SDK/OpenAPI/开发者门户内容、终端用户入门/教程/FAQ/帮助中心、发布说明与 CHANGELOG、幻灯片与路线图演示、产品定位与上市文案,以及必须先决定的功能或 API 设计本身。
主要能力:先归一化为一个主模式(prd、spec、architecture、adr、runbook、migration、internal-guide),并记录受众、事实来源、生命周期状态、文档载体、评审需求;再确认受众与排除范围,收集最小技术证据,选择最小够用结构,应用各模式写作规则(规格区分目标与非目标,架构说明边界与取舍,ADR 聚焦单项决策,运行手册优化高压下的快速行动,迁移指南突出兼容性、验证与回滚),采用 docs-as-code 友好写法,执行质量检查,最后返回简短提纲或成品。
使用方式:按需加载参考文件,不要一次读完,包括 document-modes-and-boundaries、mode-structures、prd、quality-checklists、docs-as-code-and-maintenance;先产出写作简报(模式、理由、受众、所用材料、假设与缺口、草稿结构、写作备注),若用户已要求成品则直接产出对应结构文档。
限制与边界:仅限内部技术文档通道;遇到外部受众或发布类产物应说明并交回。缺少证据时须显式标注假设,不得假装权威。分类中未提供收费、价格、平台或效果信息。