22 added, 0 removed. Audit A to A.
---
name: clarify-before-change
description: 在修改前澄清范围、风险、假设与验收标准,避免误改。用于修改 Skill、AGENTS.md、项目规则、工作流规则、仓库结构、复杂代码或具有结构影响的文档,也用于优化 Skill、调整规则、重构、重组或需求不完整的场景。
---
# 修改前澄清
## 适用范围
当修改目标、业务含义、影响范围或验收标准存在实质歧义时使用。本 Skill 只建立变更边界,不执行修改。
## 工作流程
1. 用一句话重述用户目标。
2. 先检查代码、配置、测试、规则、调用关系和历史行为,优先从仓库证据消除歧义。
3. 列出仍然会影响目标、业务语义或不可逆范围的缺失信息。
4. 明确默认假设、主要风险、受影响文件和可回滚方式。
5. 给出最小可执行路径和验收标准。
6. 只有缺失信息确实阻止继续时才提一个关键问题;否则采用可逆假设继续。
+ ## 意图解析策略(Canonical)
+
+ > 本节是全部执行类 Skill 中"是否需要询问用户"的唯一权威语义。其他 Skill(unified-taskflow、task-mode-router、subagent-execution-governance 等)的询问/确认规则不得比本节更宽。
+
+ ### 自主解析顺序(先自己解决)
+
+ 缺失信息可按以下任一途径获得的,必须先自行获取,不得询问用户:
+
+ 当前上下文 → Personal Memory / Project State → 仓库 / config / tests → 历史 trace / sessions → web / docs → 可逆实验。
+
+ ### 可逆假设(记录即推进,不暂停)
+
+ 存在多个合理选择,但同时满足:可逆、低成本、不改变用户目标、无重大外部后果 —— 选择最合理默认值,在决策记录中登记 assumption,继续执行。禁止暂停等待确认。
+
+ ### 允许询问(穷尽后才问,一次问完)
+
+ 只有答案会实质改变以下之一时才允许提问:objective / 业务语义 / 不可逆动作 / 隐私与安全暴露 / 有意义的成本 / 互斥价值偏好。确需提问时,最多一轮把真正必要的问题问完,禁止挤牙膏式反复澄清。
+
+ ### 续接语义("继续" = 已授权推进)
+
+ 用户说"继续 / 做完 / 接着做 / 自主推进 / 按之前目标完成",统一解释为:在当前 objective / critical constraints / non-goals 内,Agent 已获得继续选择下一步的授权。禁止:重新让用户选择计划、重新确认已知信息、重复询问是否继续、重新进行完整 Phase 0。先恢复 current state → 未闭合 done criteria → next best action,然后直接推进。
+
## 证据门禁
将请求分为:
- `audit`:只读检查,不创建报告、不修改文件、不同步目的地。
- `change`:用户已授权的可逆修改,有明确目标和验证方式。
- `high-risk`:删除、移动、用户级/全局写入、凭据、权限或外部系统操作。
不要因为“可能存在不确定性”就停下;只有答案会改变目标、业务意义或不可逆范围时才提问。
## 决策记录
中型或大型修改在动手前记录:
```text
事实:已由仓库证据确认的内容
假设:尚未确认但可逆的选择
风险:文件、行为、数据和外部状态影响
最小路径:满足目标的最小改动
非目标:明确不改的相邻内容
状态:proceed | ask | blocked
```
## 输出契约
审计或已完成的澄清应报告目标、证据、假设、风险、最小路径、非目标和状态。需要提问时最多提出一个会改变执行边界的问题。
## 验证
继续执行前确认:目标路径已确定、写入权限已获得、删除/移动目标已精确解析、验收条件可观察。相关示例见 [ambiguous-restructure.md](examples/ambiguous-restructure.md)。