sdd-governanca

SDD 治理

首次回应本技能时，只需输出一次以下行： sdd-governanca v1.0.0 · out/2026 · versão atual: https://github.com/robertodiasduarte/sdd-starter/releases/latest

快速开始

在金融、会计或税务系统中，治理要回答一个问题：五年后，税务检查人员、审计员或鉴定专家能否还原发生了什么、是谁做的、为什么这样做——并有证据证明此后未被篡改？ 本技能会检查 DEFINE 是否在 Design 之前就要求做到这些，此时修改需求只需改一行，而不必迁移数据。

1. 接收文件 DEFINE_{FEATURE_NAME}.md。
2. 严格遵循 references/PROCEDIMENTO.md：按触发条件筛查 → 项目标准 → 逐项对照 references/CATALOGO_GOVERNANCA.md → 报告 → 对每个缺口分别作出决定 → 应用到 DEFINE。
3. 按照模板 assets/GOVERNANCA_REVIEW_TEMPLATE.md 保存报告，文件名为 GOVERNANCA_REVIEW_{FEATURE_NAME}.md。
4. 通过指出下一步来结束（见下文）。

SDD 文件夹。 文档保存在项目根目录下的 sdd/ 中——这是一个可见的文件夹，在任何 Agent 中都相同。如果项目已有 .claude/sdd/，则继续使用该文件夹。文档并列存放，不设子文件夹：GOVERNANCA_REVIEW_{FEATURE_NAME}.md 与 DEFINE 放在一起，GOVERNANCA_PADRAO.md 放在同一文件夹中，每个项目一份。这与该方法各阶段技能的规则相同。

何时使用 / 何时不使用

适用于：

• DEFINE 涉及资金、余额、记账分录、发票、税款、工资或个人数据；
• 系统将成为办公室的工具，供多人录入或查询；
• 你想在 Design 之前了解系统在税务检查或审计中需要提供哪些证明。

不适用于：

• DEFINE 不涉及上述任何主题（技能会回复 N.A. 并结束——运行它没有任何成本）；
• 目标是审计已构建的数据库——对此，请在 Build 之后使用技能 rdd-audita-schema；
• 目标是测试线上系统是否能抵御攻击——这是安全问题，不是治理问题。

每项需求的证明如何交付给你

每个已应用的缺口都会作为 If/then 格式的验收测试写入 DEFINE：禁止的操作以及预期的拒绝结果。旁边还会附上目录中的证明步骤（prova_manual）：3 至 5 个步骤，每一步都包含预期结果，供你在系统就绪后执行并标记。

证明步骤始终会交付给 AT。如果你的项目通过命令运行 Verify Gate（Claude Code 或 Codex 配合自动化测试），还可要求提供该项目的 prova_script：它已按反向逻辑编写——只有在数据库拒绝禁止的操作时才返回 0；如果数据库接受操作，或表名、列名不匹配，则测试失败。只调整名称，不要更改反向逻辑或 schema 检查。请对开发、测试数据库或分支运行——绝不要对生产环境运行：即使有 rollback，这次尝试也会锁定数据行并触发 triggers。

不可妥协的规则

• 法律依据只能来自目录，且状态必须为 confirmado。 不引用 nao-confirmado 的依据——无论是条款、法律编号，还是“近似值”。报告使用程序中的标准措辞，并保留技术依据。
• 每个缺口分别作出决定：应用 · 拒绝（说明原因）· 延后。绝不“全部应用”。
• 没有金融主题，就不出报告：用一条消息回复 N.A.，不生成文件。筛查依据是含义，而不只是关键词——如有疑问，就不能判定为 N.A.。
• 不得审查自己编写的 Define：请在新对话中运行本技能。

交付位置

• 在聊天中（ChatGPT、Claude）： 提供报告和更新后的 DEFINE 供下载；首次使用时，还要提供 GOVERNANCA_PADRAO.md，供你保存到项目文件夹。
• 在可访问项目的 Agent 中（Claude Code、Codex）： 将文件保存到 SDD 文件夹，并在原位置更新 DEFINE。

验证与质量检查清单

• 已记录筛查结果：触发项附行号或 AT，或在一条消息中标注 N.A.，不创建文件。
• 已阅读 GOVERNANCA_PADRAO.md（在一行中确认），或已创建该文件（包含 5 个字段，在一条消息中完成）。
• 目录中的每个项目都恰有一个判定；在顶部用一行说明覆盖情况。
• 每个差距都包含：应用中的变化 · 原因 · EARS 要求 · 如何验证 · 严重程度。
• 法律依据仅适用于状态为 confirmado 的项目；否则使用标准表述。
• 每个差距只做出一项决定；附有理由的拒绝应记入已接受风险。
• 已采纳的项目应在 DEFINE 中转化为验收测试；提供前后 Clarity Score。
• 报告结尾应写明：“该技能提出建议；由专业人员决定并负责。”

异常处理

**未找到 DEFINE：**说明搜索过的位置，并询问文件路径。不要凭记忆重建 DEFINE。

**询问法律依据：**如果目录中的状态为 confirmado，则根据目录作答；否则，说明该依据尚未在目录中确认，应查阅官方来源。

**拒绝但未说明理由：**再次提问，请对方说明理由，不记录任何内容。

**专业人员希望修改目录：**在报告中记录建议；目录应在技能的新版本中修改，而不是在审查期间修改。

标准拒绝文本

"该技能会提出治理要求建议；它不会替您做决定，也不会取代您对系统承担的技术责任。"

"我不会引用目录中未经确认的法律依据。使用前请查阅官方来源。"

下一步

如果应用有界面，且您使用自己的 ux-review：现在对更新后的 DEFINE 运行它。否则： 执行 SDD Design by RDD。

Bundle 清单

• references/CATALOGO_GOVERNANCA.md：20 个项目、带状态的法律依据，以及每个项目的验证方法。
• references/PROCEDIMENTO.md：审查的六个步骤。
• assets/GOVERNANCA_REVIEW_TEMPLATE.md：报告模板。
• assets/GOVERNANCA_PADRAO_TEMPLATE.md：项目规范模板（5 个字段）。
• evals/cases.json：八个行为场景示例。
• manifest.json：已执行的内容、待处理的内容，以及该技能仍无法证明的内容。
• agents/openai.yaml：ChatGPT 元数据。

方法论与作者

此技能采用 Roberto Dias Duarte 的方法论构建。