dgr

LLM 输出的审计就绪决策工件 — 假设、风险、建议和审查门控（架构有效的 JSON）。

# DGR — Decision‑Grade Reasoning (Governance Protocol)

**Purpose:** produce an auditable, machine‑validated decision record for review and storage.

**Slug:** dgr · **Version:** 1.0.4 · **Modes:** dgr_min / dgr_full / dgr_strict · **Output:** schema-valid JSON

## What this skill does
DGR is a **reasoning governance protocol** that produces a **machine‑validated, auditable artifact** describing:
- the decision context,
- explicit assumptions and risks,
- a recommendation with rationale,
- and a consistency check.

This skill is designed for **high‑stakes** or **review‑required** decisions where you want traceability and structured review.

## How to use
1. **Ask your question** — Provide a decision request or problem context
2. **Pick mode:** `dgr_min` | `dgr_full` | `dgr_strict`
3. **Store JSON artifact** in ticket / incident / audit log

## What this skill is NOT (non‑claims)
This skill does **NOT** guarantee:
- correctness, optimality, or truth,
- elimination of hallucinations,
- legal/medical/financial advice suitability,
- or regulatory compliance by itself.

DGR improves **process quality** (clarity, traceability, reviewability) — not outcome certainty.

## When to use
Use when you need:
- an auditable record of reasoning,
- explicit assumptions/risks surfaced,
- reviewer‑friendly structure,
- a consistent output format across tasks and models.

## Inputs
- A user request/question (free text).
- Optional: context identifiers (ticket ID, policy name), and desired **mode**: `dgr_min`, `dgr_full`, or `dgr_strict`.

## Mode Behavior

| Mode | Speed | Detail Level | Clarifications | Review Required | Use Case |
|------|-------|--------------|---------------|----------------|----------|
| `dgr_min` | Fastest | Minimal compliant output | Only critical gaps | Risk-based | Quick decisions, low stakes |
| `dgr_full` | Moderate | Fuller decomposition + alternatives | More proactive | Balanced | Standard decision support |
| `dgr_strict` | Slower | Conservative analysis | More questioning | Default on ambiguity | High-stakes, uncertain contexts |

## Outputs
A single JSON artifact matching `schema.json`.

Minimum acceptance criteria (see `schema.json`):
- at least **1 assumption**
- at least **1 risk**
- `recommendation` present
- `consistency_check` present

## Safety / governance boundaries
- Always **ask for clarification** if key decision inputs are missing.
- If the decision is high‑risk, escalate via `recommendation.review_required = true`.
- If uncertainty is high, explicitly state uncertainty and limit scope.
- Do not fabricate sources or cite documents you did not see.

## Files in this skill
- `prompt.md` — operational instructions
- `schema.json` — output schema (stub aligned to DGR spec)
- `examples/*.md` — example inputs and outputs
- `field_guide.md` — how to interpret DGR artifact fields

## Quick start
1) Provide a decision request.
2) Choose a mode (`dgr_min` default).
3) The skill returns a JSON artifact suitable for review and storage.

## Changelog
**1.0.4** — Remove redundant CLAWHUB_SUMMARY.md; summary now sourced from SKILL.md front-matter.

**1.0.3** — Tighten front-matter description for better conversion, add reasoning category, compress identity block for faster scanning.

**1.0.2** — Add ClawHub front-matter metadata with emoji and homepage for improved discovery and presentation.

**1.0.0** — Initial public release of DGR skill bundle with auditable decision reasoning framework, governance protocols, and structured output format.

> Note: This is an **opt‑in** reasoning mode. It is meant to be used alongside human decision‑making, not as a replacement.

---

## 中文说明

# DGR — 决策级推理（治理协议）

**目的：** 生成一份可审计、经机器验证的决策记录，供审查和存储使用。

**Slug：** dgr · **版本：** 1.0.4 · **模式：** dgr_min / dgr_full / dgr_strict · **输出：** 符合架构的 JSON

## 此技能做什么
DGR 是一个**推理治理协议**，它生成一份**经机器验证、可审计的工件**，用于描述：
- 决策上下文，
- 明确的假设和风险，
- 带有理由的建议，
- 以及一致性检查。

此技能专为需要可追溯性和结构化审查的**高风险**或**需审查**决策而设计。

## 如何使用
1. **提出你的问题** —— 提供决策请求或问题上下文
2. **选择模式：** `dgr_min` | `dgr_full` | `dgr_strict`
3. **将 JSON 工件存储**到工单 / 事件 / 审计日志中

## 此技能不是什么（非主张）
此技能**不**保证：
- 正确性、最优性或真实性，
- 消除幻觉，
- 法律/医疗/金融建议的适用性，
- 或其本身能满足监管合规。

DGR 改进的是**流程质量**（清晰度、可追溯性、可审查性）——而非结果的确定性。

## 何时使用
当你需要以下内容时使用：
- 可审计的推理记录，
- 明确呈现的假设/风险，
- 审查者友好的结构，
- 跨任务和模型的一致输出格式。

## 输入
- 用户请求/问题（自由文本）。
- 可选：上下文标识符（工单 ID、策略名称），以及所需的**模式**：`dgr_min`、`dgr_full` 或 `dgr_strict`。

## 模式行为

| 模式 | 速度 | 细节程度 | 澄清 | 是否需要审查 | 使用场景 |
|------|-------|--------------|---------------|----------------|----------|
| `dgr_min` | 最快 | 最小化的合规输出 | 仅针对关键缺口 | 基于风险 | 快速、低风险决策 |
| `dgr_full` | 适中 | 更完整的分解 + 备选方案 | 更主动 | 平衡 | 标准决策支持 |
| `dgr_strict` | 较慢 | 保守分析 | 更多质询 | 在含糊时默认需要 | 高风险、不确定的情境 |

## 输出
一份符合 `schema.json` 的 JSON 工件。

最低验收标准（参见 `schema.json`）：
- 至少 **1 个假设**
- 至少 **1 个风险**
- 存在 `recommendation`
- 存在 `consistency_check`

## 安全 / 治理边界
- 如果关键决策输入缺失，始终**请求澄清**。
- 如果决策属于高风险，通过 `recommendation.review_required = true` 进行升级。
- 如果不确定性很高，明确陈述不确定性并限制范围。
- 不要捏造来源或引用你未曾见过的文档。

## 此技能中的文件
- `prompt.md` —— 操作说明
- `schema.json` —— 输出架构（与 DGR 规范对齐的存根）
- `examples/*.md` —— 示例输入和输出
- `field_guide.md` —— 如何解读 DGR 工件字段

## 快速开始
1) 提供一个决策请求。
2) 选择一个模式（默认 `dgr_min`）。
3) 该技能返回一份适合审查和存储的 JSON 工件。

## 变更日志
**1.0.4** —— 移除冗余的 CLAWHUB_SUMMARY.md；摘要现在来源于 SKILL.md 前置内容。

**1.0.3** —— 收紧前置内容描述以改善转化，新增 reasoning 类别，压缩身份块以加快扫描。

**1.0.2** —— 添加带 emoji 和 homepage 的 ClawHub 前置元数据，以改善发现和展示。

**1.0.0** —— DGR 技能包的首次公开发布，包含可审计决策推理框架、治理协议和结构化输出格式。

> 注意：这是一种**选择启用**的推理模式。它旨在与人类决策一同使用，而非作为其替代品。