用途:撰写与审计技术文档、API 文档、用户指南和规格说明,核心检验标准是假想读者能否仅凭该文档完成任务。
主要能力:按五个失败模式审查文档——受众失准(假设读者不具备的知识或过度解释)、不完整(缺少衔接性知识)、顺序错误(前置条件出现太晚、步骤乱序、排错信息位置不当)、精确度不足(术语不一致、指令含糊、被动语态掩盖执行者)、缺少示例(非显而易见步骤无具体示例)。
使用方式:先做受众画像并确认文档与目标读者;再依次执行完整性审计、顺序审计、精确度审计、示例审计;过程中通过 AskUserQuestion 确认框架与范围(完整分析、仅关键发现、特定聚焦或重新框定);最后按固定格式输出审计结果,包含受众校准、完整性缺口、顺序问题、精确度标记、缺失示例和重写建议。
适用场景:技术文档、API 文档、用户指南、规格说明的撰写与审查。
限制:资料未提供具体安装命令、收费方式、支持平台或实测效果;该技能依赖与 /s4h-writing-audience-calibration、/s4h-writing-restructure、/s4h-writing-line-editing 等技能配合使用。