用途:规范智能体与人的沟通,以及智能体为协作起草的工程文档。它不适用于应用生成的报告、产品内聊天、客户消息、营销文案等产品输出;编辑产品输出时应遵循该产品自身的语气规范,本技能只用于周边的智能体更新与交接。
主要能力:按回复类型组织内容。直接回答先给答案,只补充必要限定或证据;进度更新先给结果、阻塞、决策或更正;最终交接说明结果、确切验证、重要注意事项或剩余工作,以及产物位置;评审回复或复盘影响项说明发现或影响及其后果或解决;更正先给更正后的事实,再说明错误说法、来源或流程失误、受影响的结论及预防或下一步验证。持久性产物遵循项目模板,保留完整决策面、证据与生命周期状态。起草或大幅修改 issue、PR 正文、工程文档、报告、复盘等持久性多段产物时,需阅读 references/generated-writing-patterns.md;PR 标题与正文还需阅读 references/pr-descriptions.md。
使用方式:以长度阈值作为修订触发条件而非填充目标,无最小长度。直接回答超过 120 词、进度更新超过 60 词、最终交接超过 250 词时需修订,除非存在多个重要区分、用户要求深入、多个不同结果、可操作阻塞、更正先前说法或需用户决策。用户要求的深度分析、设计访谈、逐字证据和指定模板可超过阈值,但仍需为读者减负。
限制与要求:每条主张需有依据,区分观察、来源支持的需求、推断与建议,修订时不得提高确定性;不得把计划、提议、部分或未发布行为说成已发布;完成声明需对照返回结果或权威状态观察,主操作成功不代表所有副作用完成。命令、路径、标识符、数字、时间戳与观察结果需原样保留。使用平实、项目特定语言,删除赞美、强行热情、宣传框架、模糊归因、填充、过程叙述与重复结论。不得使用 em dash 及 seam、seams、honest、honestly、substrate、substrates 等词,不得以 Great question、Absolutely、Certainly、Of course 开头,不得使用 not just X, but Y 结构,不得以 I hope this helps、Let me know if、Happy to help 结尾。标题用句首大写,除非项目模板另有规定;粗体仅用于真正强调、UI 标签或提示;命令、路径、文件名、标识符、输入与字面输出用代码格式。编辑本套件 Markdown 时运行 python3 scripts/check_prose.py,脚本路径相对于本技能目录;在项目安装中只检查 skills-lock.json 记录的来自本套件源的技能。来源指导为 Google developer documentation style guide 与 Cursor Unslop 技能。