CtrlK
BlogDocsLog inGet started
Tessl Logo

clarify-before-change

在修改前澄清范围、风险、假设与验收标准,避免误改。用于修改 Skill、AGENTS.md、项目规则、工作流规则、仓库结构、复杂代码或具有结构影响的文档,也用于优化 Skill、调整规则、重构、重组或需求不完整的场景。

63

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/clarify-before-change/SKILL.md
SKILL.md
Quality
Evals
Security

修改前澄清

适用范围

当修改目标、业务含义、影响范围或验收标准存在实质歧义时使用。本 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:删除、移动、用户级/全局写入、凭据、权限或外部系统操作。

不要因为“可能存在不确定性”就停下;只有答案会改变目标、业务意义或不可逆范围时才提问。

决策记录

中型或大型修改在动手前记录:

事实:已由仓库证据确认的内容
假设:尚未确认但可逆的选择
风险:文件、行为、数据和外部状态影响
最小路径:满足目标的最小改动
非目标:明确不改的相邻内容
状态:proceed | ask | blocked

输出契约

审计或已完成的澄清应报告目标、证据、假设、风险、最小路径、非目标和状态。需要提问时最多提出一个会改变执行边界的问题。

验证

继续执行前确认:目标路径已确定、写入权限已获得、删除/移动目标已精确解析、验收条件可观察。相关示例见 ambiguous-restructure.md

Repository
ooooooooooooooooooop/agent-tools
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.