用途:作为主动写作伙伴,协作起草、修订并做读者测试,适用于提案、RFC、决策记录、技术规范、战略等实质性文档。流程深度随请求调整,不强制固定访谈。
主要能力与用法:
- 建立写作契约:确定文档类型与要促成的决策、主要与次要读者、期望的读者行动或理解、格式/长度/截止时间/审批约束、来源材料与权威级别、目标文件或共享文档。只问会实质改变文档的问题,接受简写与零散上下文。
- 构建证据地图:把输入分为已验证事实、决策(记录负责人、理由与后果)、约束(说明对备选方案的影响)、假设(明确标注并指出需验证)、开放问题(跟踪负责人或下一步)、意见(归属或转为有理由的建议)。可读取被引用的文件或已连接来源;不声称访问不存在的集成或工具;不虚构缺失的相关方立场。
- 提出结构:给出适合文档目的的提纲,只解释非显而易见的排序;对已有文档保留有用结构,提出聚焦修改而非整体替换。典型决策文档流程:执行摘要、背景与问题、目标与非目标、约束与证据、考虑过的选项、建议与理由、风险与缓解、上线/验证/归属、开放问题。
- 起草与精炼:先写最高价值章节;术语一致,歧义术语只定义一次;偏好具体主张、示例与决策标准;保留用户语气与指定语言;用“待确认”或等效标记标出证据缺口;单独跟踪重大未决决策;编辑文件时展示或总结重大结构变更,不覆盖无关内容。
- 读者测试:按读者契约检验文档,预测新读者会问的问题,检查文档能否脱离对话上下文回答;找出歧义代词、未定义术语、隐藏假设、无支撑主张与缺失过渡;确认所需决策或行动显而易见;反复修订直至无重大读者缺口。若有独立智能体且测试安全,可让全新智能体在不知预期答案的情况下阅读文档与读者问题;否则仅凭文档文本做冷读。
完成契约:交付或更新所需产物后,报告最终结构与重大决策、未决问题及已知负责人、仍需验证的证据、发现并修正的读者测试问题、以及创建文件时的确切输出位置。
路由:产品文档套件与 PRD 层级交给 full-stack-doc 技能,安装:npx skills add full-stack-skills/document-skills --skill full-stack-doc;技术教程与集成文章交给 technical-blog-doc 技能,安装:npx skills add full-stack-skills/document-skills --skill technical-blog-doc;API 参考生成交给 api-doc-generator 技能,安装:npx skills add full-stack-skills/document-skills --skill api-doc-generator。当相关方背景、论证结构或读者测试是主要挑战时,可与专用技能配合使用。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;不虚构功能或使用步骤。