docs-feedback-triage

文档反馈分类

使用此技能将开发者文档反馈转化为有效、可执行且已确定优先级的工作。它能帮助 Agent 避免将所有评论一视同仁，同时保留用户提供的证据。

此技能源自 Docs for Developers: An Engineer's Field Guide to Technical Writing，尤其是第 8 章“收集并整合反馈”。此外，它还扩展了 Christopher Gales 和 Splunk Documentation Team 的 The Product Is Docs: Writing Technical Documentation in a Product Development Group 中经改述的指导，尤其是第 5 章“客户反馈与社区”、第 18 章“与客户支持团队合作”和第 20 章“与一线团队合作”。请勿将书中的原文复制到面向用户的输出中。来源：https://link.springer.com/book/10.1007/978-1-4842-7217-6

快速开始

1. 加载 guidelines.md，选择最精简且实用的参考资料集。
2. 确定反馈来源、受影响的文档、对用户的影响、是否需要回应，以及问题是否由文档团队负责。
3. 在建议开展工作前，评估反馈的有效性、可执行性和重要性。
4. 使用 workflows/triage-doc-feedback.md 完成全面的分类流程。
5. 如果反馈会改变产品、支持或文档工作，请与用户或相关团队跟进，形成闭环。

默认输出

对反馈进行分类时，返回：

1. 反馈摘要 - 来源、受影响的文档、用户类型和所报告的问题。
2. 分类 - 有效／无效／需要调查、文档／产品／支持问题、是否重复。
3. 可执行性 - 信息是否可复现、范围是否明确、是否可修复。
4. 优先级 - 严重程度及理由。
5. 建议采取的行动 - 修正文档、转交处理、跟进或不采取行动。
6. 后续跟进 - 用户回复、负责人及需收集的证据。

目录

需求	从这里开始
了解反馈渠道	references/core/knowledge.md
应用分类规则	references/core/knowledge.md
查看分类示例	references/core/knowledge.md
对反馈进行分类	workflows/triage-doc-feedback.md
根据任务选择路径	guidelines.md

核心原则

• 反馈是证据，而非直接命令。
• 区分文档问题与产品、支持、定价或政策问题。
• 根据对用户的影响和可修复性确定优先级。
• 将公开／社区反馈同时视为支持信号和建立信任的机会。
• 如果用户花时间报告了真实问题，请跟进。