用途
vibe-writing 用于智能体辅助编程工作中的开发文本写作，目标是“为下一位使用它的读者”写出可持久的文本。该技能明确指出，在智能体辅助编码场景下，默认读者是 LLM，因此文本需要精确的契约、稳定的锚点以及显式的证据。它适用于撰写、修订、审阅或评审开发文本、源码注释、docstring 等以写作为主要任务的情形。
主要能力与写作规则
效果与写作边界
技能要求“不写超出阶段所声明效果类别与边界允许的内容”。若本包给出更窄的限制，以更窄者为准。它把阶段效果分为几类：
- 只读：仅在对话中报告；不编辑任何文件、不运行会改变状态的命令，也绝不 stage、commit、tag、push、改版本、删除数据或启动服务。仅当用户明确要求保存产物时才写文件。
- 仅产出物：只创建或更新该阶段拥有的产物及其文本声明的支撑路径，例如已确认的计划反思或决策记录，并将其留在工作区中。此类阶段不得实现可执行行为、不得把编辑代码或测试当作实现、不得产出其他阶段的产物、不得做发布工作，也不得把自身产物视为同一回合的实现授权。
- 状态变更：只在声明范围内编辑和运行命令，且限于最小可验证单元；除非用户选定，否则不触碰其他路径、既有改动以及运行时或外部状态。
上述限制同时覆盖 shell 命令（重定向、sed -i、tee、mv、cp、rm、git checkout --）和文件工具；被拒绝的写入应作为边界停止上报，且不得通过其他工具重试。任何不可逆或对外的操作都需要单独的同意。
持久记录
在记录已定决策、推迟某条发现或应用/更新既有记录前，需先读取 references/durable-records.md。该阶段写入 docs/decisions/ 与 docs/reports/findings/，或仓库既有的记录目录，作为声明的支撑路径。
提交选择
纯文档阶段绝不选择提交。已验证的产物改动留在工作区；调用、路径放置、跟踪状态、通过的评审或审计、反思同意或产物完成都不构成选择提交。只有当前用户的明确请求才能选择一个提交，且范围限于该阶段拥有的产物；提交工作流（若无可见者则由阶段自身）在文件集审查、消息传输、已存消息验证以及推送与历史边界下执行提交。起草期间绝不 stage、commit、push、release、改版本或重写历史，产物也不得授权实现、推送、发布、版本变更或历史重写。
辅助措辞模式
当另一个工作流处于活动状态时，本技能仅用于措辞，除非用户要求独立的写作产物。活动工作流对范围、验证、发布和提交决策保有权力。
范围边界
不重写价值在于精确性的文本：逐字的工具或日志输出、协议片段、引用的源码或纯确认语；应原样转述或绕开回答。对临时进展文本保持简短；除非被要求，不要把原始日志润色成摘要。
读者优先级
默认面向 LLM 优化的开发文本：直接陈述事实、契约、约束和证据；保留有用的稳定锚点；去除填充内容；显式说明缺失。当产物主要面向人时（如终端用户文档、UI 文案、支持文案或公开发布说明），使用面向人优化的行文。
证据与含义
不得编造原因、目标、结果、影响、测试、安全/性能、发布或降险方面的论断。已提供的能力并不构成对其原因、目的、效果、证据或收益的证明。
当前提示中表述的工作流状态应视为已提供证据。当仅需回复的任务说明改动已暂存、编辑已完成、检查已通过或其他工作流事实已确立时，应基于该表述状态写作。除非提示明确将该检出绑定为待检查目标，否则不要用 eval 沙箱、运行器或环境检出的当前状态替换它。若任务只要求消息、命令序列或收尾记录，不要仅仅因为工具可用就执行表述中的变更。仅当表述中的当前请求选择了某个提交，或拥有工作流的检查点涵盖表述中的改动时，才描述提交机制。
保留事实、范围、条件、例外、警告、必需动作、有意义的顺序和情态。当有用的本地术语和标识符是搜索锚点、工作流标签、契约或领域语言时，予以保留。若“更干净”的句子改变了义务、适用性、许可或失败行为，那就是错的。
语言与格式
对话语言：单独于任何产物语言来解析面向用户对话文本的语言，顺序为：1) 当前用户对对话、回复或输出语言的明确指令；2) VIBE_CHAT_LANGUAGE（语言名或 BCP47 标签，如 ja 或 pt-BR），当可读或由用户为本请求设置时；空值或无效值视为未设置；3) 用户当前对话语言，否则为本工作流中最近明确的语言；4) 英语。绝不从产物、文件内容、路径、命令、代码、技能调用或宿主包装文本推断对话语言，除非用户将其设为语言契约。路径、命令、标识符、环境变量、locale 标签、消息键、产品名和代码保持逐字，除非用户要求翻译。
产物语言：按以下优先级选择：1) 用户明确指令，包括翻译或本地化请求；2) 为所请求产物已选定的活动工作流或产物专属语言契约，包括配置驱动的文档语言设置；3) 既有产物语言；4) 文件名 locale 标记，如 README.ja.md 或 docs/de_de/guide.md；5) 项目约定；6) 英语。产物语言不跟随对话语言。除翻译或重命名请求外，保留对话语言保留的逐字内容以及规范字符串。用所选语言撰写生成的正文，但在有用引文、术语、标识符或证据锚点处保留原语言措辞。
格式与精确性：除非要求解释，否则直接返回产物，不加 Markdown 围栏、仅提示性的包装文字或来源说明。保留必要的换行、命令和机器可读结构；精确格式不允许额外文字或杜撰字段。对不受支持的论断按语义移除，同时在允许处保留所需模式，填入受支持的中性或空值。
产物专属指引
产物专属规则见 references/artifact-guidance.md。在起草提交信息、传输或修复已存消息前，读取 references/commit-messages.md；在做变更日志工作前，读取 references/changelog.md。当本阶段自身执行正文提交或修正时，检查已存消息并在报告完成前纠正畸形字节。决策记录和发现报告遵循 Durable Records。
持久引用
产物应能脱离提示独立存在。用持久事实或有用的可解析引用替换仅存在于提示中的引用和机器本地上下文。
使用方式
该技能以文档规则形式提供，通过 agent-skills 机制被调用。其内容本身即为写作时应遵循的约束集合，未提供安装命令或配置步骤。
适用场景
适用于智能体辅助编码过程中的开发文本撰写、修订、评审与评述，包括源码注释、docstring、决策记录、发现报告、提交信息与变更日志等文本交付物，也包括其重写、润色或本地化。
限制
效果类别与边界、提交选择权、语言优先级等规则对写作内容构成明确约束；不得编造功能、测试、性能、安全或发布相关论断。关于收费、价格、平台支持等事实，资料暂未提供。