agf-writing-change

# Writing a Change（变更文件夹入口） 变更文件夹（`docs/changes/<change>/`）是 AGF 自 v6.9.0 起的**新需求入口**，取代 PRD（OpenSpec 风格，决策见 [ADR-012](../../../docs/adr/012-spec-driven-change-folders.md)）。它把需求表达成**对活规格的 delta**，交付签字后 merge 进 `docs/specs/`——让「系统当前有哪些行为」永远有 SSOT。 Use this skill when： - product-lead 跑完 `superpowers:brainstorming` 且用户批准了大方向。 - 要把一个 feature 正式化成 `docs/changes/<change>/` 四件套，再派工。 - 既有 change 在 open question 解决后更新。 > **验证脊柱不变**：apply 之后的 SIT 自跑 / code review + SIT Audit / 部署门 / E2E / UAT pass² / 业务签字全照旧。本 skill 只管**入口**。 ## Pre-conditions - [ ] 方向已获批（还在探索 → 先 `superpowers:brainstorming`，别建 change）。 - [ ] 知道用户是谁、优化什么业务结果。 - [ ] 至少 1 个可测的成功标志。 任一不满足：**停，别建 change**，回 brainstorming 或 SendMessage 用户澄清。 ## 建一个 change ```bash cp -r docs/changes/_TEMPLATE docs/changes/<change-kebab-case> ``` `<change>` 用 kebab-case 动词短语（如 `add-dark-mode`、`oauth-login`）。一个 change 一个文件夹。 ## 四件套 ### 1. `proposal.md` —— why + what + scope - **Why**：用户痛点 / 业务驱动（1–3 段）。 - **What**：本次交付的能力一句话；**Non-Goals** 至少 1 项。 - **影响的能力**表：列触及的 capability + 对应活规格路径 + 本次 delta 文件（新建能力标 NEW）。 - **Open Questions**：每条标 Owner + Due（缺则不进派工）。 - 顶部填 effort tier（Small/Medium/Large）+ **交付 lane**（full/fast；高风险一律 full）。 ### 2. `specs/<capability>.md` —— delta（唯一会 merge 进活规格的部分） 对每个触及的能力写一个 delta 文件（文件名 = capability kebab-case）。段头**只保留用到的**： ```markdown ## ADDED Requirements ### Requirement: <新行为名> The system MUST <规范性契约>. #### Scenario: <名> - WHEN <触发> - THEN <可观察结果> ## MODIFIED Requirements ### Requirement: <既有行为名> ...