/install contradiction-detector
Contradiction Detector
Contradictions between agent instruction files are the #1 cause of silent misbehavior in multi-agent OpenClaw setups. Files are loaded non-deterministically across sessions — the only fix is making all files agree.
Prerequisites
openclawCLI — listing agents and cron jobspython3— parsing JSON configfind,cat— standard POSIX utilities- Filesystem access to the OpenClaw workspace directory
Audit Procedure
Step 1 — Discovery
Enumerate every instruction source: all agents, their workspace files (AGENTS.md, SOUL.md, HEARTBEAT.md, MEMORY.md, IDENTITY.md, USER.md), all cron jobs with inline prompts, all installed skills, and any hook scripts.
→ Detailed procedure: references/discovery.md
Build a complete inventory per agent before proceeding. Missing even one source means contradictions slip through.
Step 2 — Cross-reference for contradictions
Systematically check every pair of instruction sources per agent against 12 known contradiction patterns:
| # | Pattern | Risk | Most common trigger |
|---|---|---|---|
| 1 | Format duplication | HIGH | Same output format defined in 2+ files independently |
| 2 | Cron prompt override | HIGH | Cron contains stale instructions; HEARTBEAT.md fix is invisible |
| 3 | Routing mismatch | HIGH | Different session/channel targets for same output |
| 4 | Persona/tone conflict | MED | SOUL.md vs AGENTS.md communication style |
| 5 | Trigger/schedule mismatch | MED | Cron frequency vs HEARTBEAT.md timing |
| 6 | Memory routing conflict | MED | Same data type sent to different memory locations |
| 7 | Dead/orphaned rules | MED | Old rule not removed after newer rule added elsewhere |
| 8 | Cross-agent assumption mismatch | MED | Sender expects X, receiver does Y |
| 9 | Implicit vs explicit behavior | LOW-MED | Gap filled differently by different files |
| 10 | Skill-agent conflict | LOW-MED | Skill instructions override agent rules when triggered |
| 11 | Stale MEMORY.md directives | LOW | "From now on" in MEMORY.md contradicts current AGENTS.md |
| 12 | Environment/config drift | LOW | Hardcoded paths, model names, or URLs that changed |
→ Full detection procedures and examples: references/contradiction-patterns.md
Step 3 — Report and fix
Produce a structured finding for each contradiction (agent, severity, pattern, evidence with exact quotes, impact, proposed fix). Present all fixes as diffs and wait for user confirmation before applying.
→ Report format, severity guidelines, and fix protocol: references/reporting-and-fixes.md
Post-fix verification
After every fix: re-read both files, verify agreement, and confirm no new contradictions were introduced.
Scheduling (optional)
This skill works as a manual on-demand invocation. Optionally add to HEARTBEAT.md or a cron job for periodic runs.
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install contradiction-detector - 安装完成后，直接呼叫该 Skill 的名称或使用
/contradiction-detector触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
Contradiction Detector 是什么？
Detects and eliminates contradictions between agent instruction files that cause hallucinations and silent misbehavior. Use when: (1) any agent behaves incon... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 165 次。
如何安装 Contradiction Detector？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install contradiction-detector」即可一键安装，无需额外配置。
Contradiction Detector 是免费的吗？
是的，Contradiction Detector 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Contradiction Detector 支持哪些平台？
Contradiction Detector 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Contradiction Detector？
由 korengast（@korengast）开发并维护，当前版本 v1.0.1。