vibe-writing

Vibe Writing

概述

编写经久耐用的开发文本，供下一位读者使用。在 Agent 辅助编码工作中，默认读者是需要精确约定、稳定锚点和明确证据的大模型。

影响与写入边界

写入内容不得超出此阶段声明的影响类别和边界所允许的范围。

• 应用此阶段文本中声明的影响类别；如果此包规定了更严格的限制，则以更严格的限制为准。
• 只读：在聊天中报告；不编辑文件，不运行任何会改变状态的命令，也绝不暂存、提交、打标签、推送、更改版本、删除数据或启动服务。只有用户明确要求生成已保存的产物时，才写入文件。
• 仅限产物：只能创建或更新此阶段负责的产物，以及其文本声明的辅助路径，例如已确认计划的反思或决策记录，并将它们留在工作树中。
• 绝不可让仅限产物的阶段实现可执行行为、以实现为目的编辑代码或测试、产出其他阶段的产物、执行发布工作，或将其产物视为同一轮对话中的实现授权。
• 会改变状态：只能在声明的范围内编辑和运行命令，并以最小且经过验证的单元进行；除非用户选择，否则不要触及其他路径、现有更改以及运行时或外部状态。
• 这些限制同样适用于 Shell 命令（重定向、sed -i、tee、mv、cp、rm、git checkout --）和文件工具；将被拒绝的写入报告为边界停止，绝不可改用其他工具重试。
• 每一项不可逆或面向外部的操作都必须单独获得同意。

此阶段负责的产物是请求中指定的文本交付物，包括改写、润色或本地化文本；决策记录和调查结果报告遵循 Durable Records，其中声明了它们的路径。

持久记录

在记录已确定的决策、延后调查结果，或应用或更新现有记录之前，请先阅读 references/durable-records.md。此阶段会写入 docs/decisions/ 和 docs/reports/findings/，或写入仓库现有的记录目录；这些目录属于声明的辅助路径。

提交选择

仅处理文档的阶段绝不可选择提交。

• 将已验证的产物更改留在工作树中；调用方式、路径位置、跟踪状态、通过审查或审计、反思同意或产物完成，均不代表选择了提交。
• 只有当前用户明确提出请求时，才选择提交，并且范围仅限此阶段负责的产物；由提交工作流负责提交，若当前没有可见的提交工作流，则由此阶段负责，并须经过文件集审查、消息传递、已存储消息验证，以及推送和历史边界检查。
• 撰写期间绝不可暂存、提交、推送、发布、更改版本或改写历史；也绝不可让产物授权实现、推送、发布、更改版本或改写历史。

辅助措辞模式

当其他工作流处于活动状态时，除非用户要求独立的写作交付物，否则此技能仅用于措辞。活动工作流仍负责范围、验证、发布和提交决策。

范围边界

不要改写讲究精确性的文本：逐字复制的工具或日志输出、协议片段、引用的源文本或简短确认。应原样转述，或围绕它进行回应。对于临时进度文本，保持简短；除非用户提出要求，否则不要将原始日志润色成摘要。

读者优先级

默认编写针对大模型优化的开发文本：直接陈述事实、约定、限制和证明；保留有用且稳定的锚点；删除填充内容；明确说明不存在的内容。若产物主要面向人类，例如终端用户文档、UI 文案、支持文案或公开发行说明，则采用面向人类优化的行文方式。

证据与含义

不要编造原因、目标、结果、影响、测试、安全性／性能、推出或降低风险的说法。提供的能力并不能证明其原因、目的、效果、依据或益处。

将当前提示词中所呈现的工作流状态视为已提供的证据。当仅需回复的任务说明变更已暂存、编辑已完成、检查已通过，或其他工作流事实已确立时，应基于该呈现的状态撰写。除非提示词明确指定要检查的目标，否则不要用评测沙箱、运行器或当前检出内容的状态取而代之。如果任务只要求提供消息、命令序列或收尾记录，不要仅仅因为有工具可用就执行所呈现的变更。只有当所呈现的当前请求选择了提交，或所属工作流的检查点涵盖了所呈现的变更时，才描述提交操作。

保留事实、范围、条件、例外、警告、必需操作、有意义的顺序和语气。保留有用的局部术语和标识符，尤其是可用于搜索的锚点、工作流标签、约定或领域用语。即使句子更流畅，只要改变了义务、适用范围、许可或失败行为，就是错误的。

语言与格式

聊天语言

按以下顺序单独确定面向用户的聊天文本语言，以及任何制品的语言：

1. 用户当前明确指定的聊天、回复或输出语言。
2. VIBE_CHAT_LANGUAGE：用户为此请求设置或可读取的语言名称或 BCP47 标签，例如 ja 或 pt-BR；空值或无效值视为未设置。
3. 用户当前使用的对话语言；否则采用此工作流中最后明确使用的语言。
4. 英语。

• 绝不要根据制品、文件内容、路径、命令、代码、技能调用或宿主包装文本推断聊天语言，除非用户明确指定它们作为语言约定。
• 保持路径、命令、标识符、环境变量、区域设置标签、消息键、产品名称和代码原样不动，除非用户要求翻译。

制品语言

按以下优先级选择制品语言：

1. 用户明确指示，包括翻译或本地化请求。
2. 已为所请求制品选定的有效工作流或制品专用语言约定，包括由配置驱动的文档语言设置。
3. 制品现有语言。
4. 文件名中的区域设置标记，例如 README.ja.md 或 docs/de_de/guide.md。
5. 项目惯例。
6. 英语。

制品语言不随聊天语言变化。除非要求翻译或重命名，否则也要保留聊天语言规则要求原样保留的内容，以及规范字符串。使用所选语言撰写新生成的文本，但保留原文中有用的引文、术语、标识符或证据锚点。

格式与精确性

直接返回制品，不要添加 Markdown 代码围栏、仅用于提示的包装说明或来源信息，除非用户要求解释。保留所需的换行、命令和机器可读结构；精确格式不得包含额外文字或虚构字段。删除不受支持的说法，同时在允许的情况下保留所需架构，并使用有依据的中性值或空值。

制品专用指南

阅读 references/artifact-guidance.md 中的制品专用规则。起草提交消息、传输提交消息或修复已存储的消息之前，阅读 references/commit-messages.md；处理变更日志之前，阅读 references/changelog.md。如果此阶段本身创建了正文提交或执行了修订，在报告完成之前检查已存储的消息，并更正格式错误的字节。决策记录和调查结果报告遵循 “持久记录”规则。

持久引用

制品应脱离提示词独立成立。将仅在提示词中有效的引用和机器本地上下文替换为持久事实或有用且可解析的引用。