Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add SuperChason/ontology-driven-ai-data-management-skills --skill fact-reason-goal-explainable-decisiongit clone --depth 1 https://github.com/SuperChason/ontology-driven-ai-data-management-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/superchason/ontology-driven-ai-data-management-skills/fact-reason-goal-explainable-decision)<a href="https://agentmods.dev/skills/superchason/ontology-driven-ai-data-management-skills/fact-reason-goal-explainable-decision"><img src="https://agentmods.dev/badge/skills/superchason/ontology-driven-ai-data-management-skills/fact-reason-goal-explainable-decision/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/superchason/ontology-driven-ai-data-management-skills/fact-reason-goal-explainable-decision"><img src="https://agentmods.dev/badge/skills/superchason/ontology-driven-ai-data-management-skills/fact-reason-goal-explainable-decision.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00083 | $0.01440 |
| Opus 5 | $0.00042 | $0.00720 |
| Sonnet 5 | $0.00017 | $0.00288 |
| Haiku 4.5 | $0.00008 | $0.00144 |
Grade A, and why
fact-reason-goal-explainable-decision scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 107 lines — stays where its author put it; the contents beside it link to each section on GitHub.
“事实—事理—目标”可解释决策
方法骨架
- 把决策依据拆成实时事实、业务事理和明确目标。
- 事实必须有来源、时间、版本和可信度,缺失或冲突不能静默补全。
- 事理提供规则、因果、约束、权限和例外,形成可追溯推理路径。
- 目标决定优化方向和取舍标准,多目标冲突要显式呈现。
- 推理输出包含结论、证据、规则路径、备选方案和不确定性。
- 低容错结论需通过权威依据或工具验证后再进入行动。
触发场景
用户会在什么情境下需要这个 Skill
- 需要解释Agent为什么得出某个业务判断
- 实时事实、业务规则和多个目标需要综合决策
- 决策结论要可追溯并支持人工复核
语言信号
- “按事实事理目标分析”
- “这个决策依据是什么”
- “多个目标冲突怎么权衡”
- 英文信号:fact-reason-goal, explainable decision, goal trade-off
与相邻 Skill 的区分
- 与
fact-reason-action-business-loop:事实事理行动覆盖完整业务闭环;本 skill 专注一次决策的依据、目标和解释。 - 与
risk-based-agent-action-modes:本 skill 形成决策;行动模式 skill 决定决策怎样安全地进入执行。
执行步骤
按当前任务选择必要步骤;已有可靠成果直接复用:
-
明确决策问题
- 动作:定义决策对象、时间、可选方案、责任人和不可接受结果。
- 完成标准:问题能产生有限个可比较方案。
-
核验事实
- 动作:收集来源、时间、版本、可信度和冲突情况,标记缺失。
- 完成标准:关键事实均有证据;无法核验的事实不进入确定性结论。
-
应用事理
- 动作:逐条运行规则、因果、约束、权限和例外,保留推理路径。
- 完成标准:每个中间结论能追溯到事实和规则。
-
权衡目标
- 动作:明确目标优先级、阈值、冲突和有权裁决角色。
- 完成标准:方案差异按同一目标体系比较。
-
输出可解释结论
- 动作:给出建议、备选、证据、规则路径、不确定性和下一步。
- 完成标准:低容错结论已验证;目标冲突或证据不足时升级人工。
固定输出
- 决策问题卡:决策编号、对象、时点、责任人、备选方案和不可接受结果
- 事实与证据表:事实、来源、时间、版本、可信度、冲突和缺失状态
- 事理与推理路径表:规则、因果、约束、权限、例外、输入事实和中间结论
- 目标与取舍矩阵:目标编号、优先级、基准、目标、阈值、冲突和裁决角色
- 备选方案比较表:方案、事实支持、规则符合、目标效果、风险、可逆性和不确定性
- 可解释决策结论:建议方案、备选方案、证据链、规则路径、目标权衡和剩余风险
- 人工升级与待确认清单
无法核验的关键事实、无权裁决的目标冲突和低容错未验证结论分别标为受阻或需人工裁决。
使用边界
不要在以下情况使用
- 事实来源和任务目标均未明确
- 纯创意、审美或情感判断
- 用户只要求定义Action接口
常见失败模式
- 用通用逻辑直接驱动自主决策:概率推理替代了企业决策逻辑,执行工具又把语言偏差转化成了现实状态变更。
- 在低容错场景接受概率性幻觉:概率生成与业务正确性目标不一致,且下游系统把文本结果当作可信决策依据。
- 把文档检索等同于可执行知识:向量相似性提供相关片段,却不能保证业务关系、方向、约束和动作条件完整呈现。
- 用错误本体生成训练数据并放大偏差:同一语义缺陷被重复采样,训练优化把局部错误提升为模型的稳定决策倾向。
使用折扣与复核要求
- 显式规则容易遗漏现实中的新因果,线上反馈和异常应持续补充事理。
- 大模型生成形式结构无法直接证明业务语义正确,生产使用需保留专家确认、工具校验、真实用例和审计记录。
相关 Skills
depends-on→fact-reason-action-business-loop;事实事理行动覆盖完整业务闭环;本 skill 专注一次决策的依据、目标和解释。composes-with→ontology-constraint-and-knowledge-injection。
审计信息
- 历史验证:v0.1.0 路由测试 6/6;v0.4.0 已通过输出契约结构校验,跨平台行为继续按版本抽样
- 首次公开版本:2026-08-21
- 来源说明:方法框架受《本体驱动的 AI 数据管理》启发;仓库不包含原书正文。
What ships with it
3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago Changed 7ce4cc72345a
- 8d ago Changed · +7 lines b34de78f72c5
- 12d ago First seen · 100 lines · 83 tokens per session scan A 2f599c5cffb2
fact-reason-goal-explainable-decision is a skill published in the GitHub repository SuperChason/ontology-driven-ai-data-management-skills (10 stars, last pushed 5d ago), licensed MIT. It adds 83 tokens to every session and 1,440 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
graph-mutation-plan
Cookbook for composing an applygraphmutations plan — stable entitykey patterns, the canonical label/edge vocabulary, evidence/invalidation/confidence discipline, and a worked example. Load this when building a non-trivial mutation plan.
open-ontologies
AI-native ontology engineering using 50+ MCP tools backed by an in-memory Oxigraph triple store. Build, validate, query, and govern RDF/OWL ontologies with a generate-validate-iterate loop. Use when building ontologies, knowledge graphs, RDF data, SPARQL queries, BORO/4D modeling, SHACL validation, clinical…
report-generation
A workflow for generating data-analysis reports as interactive HTML with charts. It is intended for trend, statistics, monthly, weekly, and other reports, using database queries and ECharts, a web charting library.
business-overview
A business performance analysis workflow that uses sales, finance, inventory, and customer data to describe how a company is operating.
enterprise-sales
A Chinese-language workflow for preparing sales visits and solution documents for government and enterprise customers. It covers checking customer records, understanding the industry, finding suitable products, and generating a Word proposal.
mykg
Run mykg knowledge-graph commands inside Claude Code from one slash command /mykg. The user describes intent in natural language (extract, append, sync, resume, approve, walkthrough, parse-docs, fetch-web, query); the skill parses intent, builds the right mykg CLI command from the live --help output, confirms, runs…