用途:撰写、编辑或审校 UI 文案、CLI 消息、帮助文本、代码注释及技术文档,覆盖产品行为、错误、状态、设置等内容。核心目标是让读者明白当前发生了什么、接下来能做什么。
主要能力与原则:
- 按任务取材:只使用与所需文案相关的部分,保留用户原意、术语、受众与格式,遵循既有产品约定。措辞任务本身不授权改动产品行为或重组文档。
- 行为陈述有据:行为描述须基于给定事实、相关实现或规范,或可观察结果;无法核实处需标明不确定,不得编造行为或原因。
- 界面文案与错误:准确命名操作或状态,区分保存与测试、接受请求与完成任务、部分成功与完全成功;给出有用的恢复信息,指出失败项与相关输入,已知且可操作时给出下一步。
- 状态与诊断输出:描述标签承诺的状态;区分未知/不可用与空/缺失/默认值;保持 JSON、TSV 等机器格式输出契约,不混入散文或装饰;保留需复制的路径、ID 和命令。
- 文档结构:每页一个职责,操作指南、参考、设计记录、报告各司其职;README 保持聚焦,快速上手给出最短完整路径;摘要与规范分离,避免重复维护;可变事实需可持续保持正确。
- 注释与独立产物:注释解释代码未显现的原因,如顺序约束、上游缺陷、兼容变通、不变量;删除仅在工作对话中成立的临时限定。
- 主张与证据:匹配主张与支持程度,性能对比需适用测量或带范围引用,兼容性主张需实现或规范支撑;区分观察、假设、偏好与建议。
- 审校与验证:指出措辞、对读者的影响及具体修改;行为变更时同步检查相关帮助文本、错误、文档和技能描述,保持目录与本地化一致。
使用方式:资料未提供具体安装命令或调用方式,暂未提供。
适用场景:产品文案与文档的写作、编辑、审校,尤其是界面文案、错误消息、CLI 输出与帮助文本。
限制:行为与事实须有依据,不得编造;不做超出措辞任务范围的产品行为变更或文档重组;具体平台、收费与安装方式资料未提供。