← ClaudeAtlas

clarify-before-changelisted

在修改前澄清范围、风险、假设与验收标准,避免误改。用于修改 Skill、AGENTS.md、项目规则、工作流规则、仓库结构、复杂代码或具有结构影响的文档,也用于优化 Skill、调整规则、重构、重组或需求不完整的场景。
ooooooooooooooooooop/agent-tools · ★ 2 · AI & Automation · score 64
Install: claude install-skill ooooooooooooooooooop/agent-tools
# 修改前澄清 ## 适用范围 当修改目标、业务含义、影响范围或验收标准存在实质歧义时使用。本 Skill 只建立变更边界,不执行修改。 ## 工作流程 1. 用一句话重述用户目标。 2. 先检查代码、配置、测试、规则、调用关系和历史行为,优先从仓库证据消除歧义。 3. 列出仍然会影响目标、业务语义或不可逆范围的缺失信息。 4. 明确默认假设、主要风险、受影响文件和可回滚方式。 5. 给出最小可执行路径和验收标准。 6. 只有缺失信息确实阻止继续时才提一个关键问题;否则采用可逆假设继续。 ## 证据门禁 将请求分为: - `audit`:只读检查,不创建报告、不修改文件、不同步目的地。 - `change`:用户已授权的可逆修改,有明确目标和验证方式。 - `high-risk`:删除、移动、用户级/全局写入、凭据、权限或外部系统操作。 不要因为“可能存在不确定性”就停下;只有答案会改变目标、业务意义或不可逆范围时才提问。 ## 决策记录 中型或大型修改在动手前记录: ```text 事实:已由仓库证据确认的内容 假设:尚未确认但可逆的选择 风险:文件、行为、数据和外部状态影响 最小路径:满足目标的最小改动 非目标:明确不改的相邻内容 状态:proceed | ask | blocked ``` ## 输出契约 审计或已完成的澄清应报告目标、证据、假设、风险、最小路径、非目标和状态。需要提问时最多提出一个会改变执行边界的问题。 ## 验证 继续执行前确认:目标路径已确定、写入权限已获得、删除/移动目标已精确解析、验收条件可观察。相关示例见 [ambiguous-restructure.md](examples/ambiguous-restructure.md)。