clarify-before-change SKILL.md skillA

clarify-before-change from ooooooooooooooooooop/agent-tools is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ooooooooooooooooooop/agent-tools/clarify-before-change@git:20260828.278776e

Pins git:20260828.278776e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ooooooooooooooooooop/agent-tools
Path
skills/clarify-before-change/SKILL.md
Versions recorded
2
Latest version
git:20260828.278776e, committed Aug 28, 2026
First version recorded
Aug 17, 2026
Size
3,799 bytes
Repository stars
4
License
MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 修改前澄清

## 适用范围

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

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ooooooooooooooooooop/agent-tools/clarify-before-change@sha256:79c0fd737d27da72

The line at the top of this page pins the label git:20260828.278776e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x6m5c2kgma2u5ayb.svg)](https://markdownregistry.com/a/art_x6m5c2kgma2u5ayb)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Aug 17, 2026 and Aug 28, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20260828.278776e latest2026-08-28 278776e 3,799 BA view · diff
git:20260817.d6c46352026-08-17 d6c4635 2,175 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3799 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ooooooooooooooooooop/agent-tools · 4 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x6m5c2kgma2u5ayb
GET https://markdownregistry.com/api/v1/resolve?ref=ooooooooooooooooooop/agent-tools/clarify-before-change
GET https://markdownregistry.com/api/v1/blob/79c0fd737d27da72d6d7d50691f915089f804c1ecd6537eb3ce04d2441117d33

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ooooooooooooooooooop/agent-tools

AGENTS.md AGENTS.md file
ooooooooooooooooooop/agent-tools · AGENTS.md
git:20261022.bc4f1e5 · audit A · 4 stars
your-skill-name SKILL.md skill
ooooooooooooooooooop/agent-tools · _template/SKILL.md · 用一句中文说明这个 Skill 能做什么,以及何时应该触发它
v0.1.0 · audit A · 4 stars
AGENTS.md@dsh-config AGENTS.md file
ooooooooooooooooooop/agent-tools · dsh-config/AGENTS.md
git:20260914.0c9411e · audit A · 4 stars
llms.txt@research/agent-harness-survey-v1/changelogs/amp llms.txt file
ooooooooooooooooooop/agent-tools · research/agent-harness-survey-v1/changelogs/amp/llms.txt
git:20260921.a69e78d · audit A · 4 stars
llms.txt@research/agent-harness-survey-v1/changelogs/qoder llms.txt file
ooooooooooooooooooop/agent-tools · research/agent-harness-survey-v1/changelogs/qoder/llms.txt
git:20260921.a69e78d · audit A · 4 stars
llms.txt@research/agent-harness-survey-v1/changelogs/replit llms.txt file
ooooooooooooooooooop/agent-tools · research/agent-harness-survey-v1/changelogs/replit/llms.txt
git:20260921.a69e78d · audit A · 4 stars
chatgpt-web-bridge SKILL.md skill
ooooooooooooooooooop/agent-tools · skills/chatgpt-web-bridge/SKILL.md · 通过 chatgpt-web 的 MCP 或 REST 桥,把本地 agent 接入已登录的 ChatGPT Web。 适用于“推进/继续网页端会话”“让网页端设计、本地执行”“协作/对等推进”,以及只读拉取网页端会话/项目资料和…
git:20260921.679541d · audit A · 4 stars
decision-gates SKILL.md skill
ooooooooooooooooooop/agent-tools · skills/decision-gates/SKILL.md · 在 DSH 长程任务中为决策层加装五道防偏闸门:原始证据锚、对抗式对齐审计、跨包一致性校验、成本比对、防御自检,防止目标漂移、验收失真与摘要偏差。用于跨会话长任务、多 worker 并行、审计类任务、成本敏感任务的 checkpoint…
v0.2.0 · audit A · 4 stars
dsh-config-sync SKILL.md skill
ooooooooooooooooooop/agent-tools · skills/dsh-config-sync/SKILL.md · 把 DSH(DeepSeek Harness)的用户配置(~/.dsh 下的 AGENTS.md、settings.yaml 及可选 profiles/预设)打包成脱敏骨架并在设备间安全同步恢复,提供只读审计、显式应用与 SHA-256…
v1.0.0 · audit A · 4 stars
environment-bootstrap SKILL.md skill
ooooooooooooooooooop/agent-tools · skills/environment-bootstrap/SKILL.md · 从源仓库向其他设备或用户级 Skill 目录恢复已登记的 Codex Skill,提供只读审计、显式应用、SHA-256 校验,并且不删除目标端额外文件。用于复现 Codex 工作环境、比较已安装 Skill…
git:20260817.d6c4635 · audit A · 4 stars
evolution-proposal SKILL.md skill
ooooooooooooooooooop/agent-tools · skills/evolution-proposal/SKILL.md · 把 evolution-inbox 中的审计异常条目转化为可评审的进化提案(规则/技能/插件/路由补丁)。先做系统化问题分析(量化基线→全量聚合→根因分类→优先级排序),再用便宜模型起草、前沿模型评审、人工批准后走既有门禁固化。用于处理…
v0.3.0 · audit A · 4 stars
execution-discipline SKILL.md skill
ooooooooooooooooooop/agent-tools · skills/execution-discipline/SKILL.md · 在 DSH 长程/多工具会话中强制九条执行纪律,防止高频反模式重演:禁止无 wait 轮询、禁止把门禁拒绝当交付物抛回决策、外部研究先探测通道再极窄探针、探查派子代理不肉身…
v0.3.0 · audit A · 4 stars

Every file in ooooooooooooooooooop/agent-tools

Other files named clarify-before-change

clarify-before-change SKILL.md skill
ooooooooooooooooooop/personal-ai · skills/clarify-before-change/SKILL.md · 在修改前澄清范围、风险、假设与验收标准,避免误改。用于修改 Skill、AGENTS.md、项目规则、工作流规则、仓库结构、复杂代码或具有结构影响的文档,也用于优化 Skill、调整规则、重构、重组或需求不完整的场景。
git:20260828.1542fea · audit A · 4 stars

Browse by kind, by grade A, or by owner.