Home / All Skills / Workflow & Core Tools / ljg-mechanism
Workflow & Core Tools · lijigang/ljg-skills

ljg-mechanism

For a user-provided phenomenon, generates mechanism hypotheses using the "Spot Anomalies – Trace Processes – Dissect Explanations – Transfer with Conditions" framework. Verifies the phenomenon online, tests critical causal links and competing explanations, and delivers the best evidence-backed mechanism along with its boundary conditions. USE WHEN a user invokes ljg-mechanism, asks to "find the mechanism," "investigate mechanisms," "run through the four-step framework," "verify this explanation online," or seeks to understand how a phenomenon occurs. NOT FOR pure concept definitions, standard summaries, operational tasks with a single known solution, or mere landscape mapping.

L1 Basic · Source registration onlyV1 Commit-PinnedDual-pass Audit
Author lijigangGitHub lijigang/ljg-skills ↗License MIT(仓库根 LICENSE)Commit 9e75497a95
Control levels describe skill capabilities and suggested control measures; they do not represent quality or safety certifications, nor do they dictate usability. Usage decisions rest entirely with users and administrators. Different agent hosts apply varying constraints; do not assume hosts provide automatic protection. Third-party skill copyrights belong to their original authors. Use at your own risk.

1How It Works & Mechanism

The entire skill is a prompt-only research framework: structuring the four steps of "Spot Anomalies – Trace Processes – Dissect Explanations – Transfer with Conditions" into an iteratively refineable closed loop that produces mechanism judgments rather than one-off answers.

skills/ljg-mechanism/SKILL.md
从眼前的现象中找出真正起作用的关系。生成解释后,让它与竞争解释一起接受现实检验;根据证据修正对象、关系或成立条件,给出当前最扎实的机制判断。
What is happening here: SKILL.md opens by positioning the research methodology, emphasizing that explanations must withstand competing theories and real-world testing, while allowing targets, relationships, and conditions to be updated as evidence emerges.

Uses Workflow Routing for task dispatch: routes phenomenon explanations to DiscoverMechanism.md, and applies the same framework with the four stages expanded for demonstration/learning.

skills/ljg-mechanism/SKILL.md
| 提供现象,希望解释其生成过程并验证 | 阅读 [Workflows/DiscoverMechanism.md](Workflows/DiscoverMechanism.md) |
What is happening here: An entry routing table that aligns both "research" and "demonstration" intents to the identical four-step framework.

Online search is the default action to verify phenomena and test mechanisms, requiring a strict separation between "scope supported by sources," subjective inferences, and pedagogical examples.

skills/ljg-mechanism/SKILL.md
默认使用当前可用的联网搜索与正文获取能力,检验现象和机制。来源支持的范围,与自己的推断、教学设例和未知分开。
What is happening here: Embeds online verification into research conventions alongside evidence tiering discipline to prevent treating inferences as proven facts.

Requires articulating mechanisms as "who generates what outcome through which intermediate changes under what conditions," forcing abstract terms like "supply-demand/incentives/systems" to be unpacked into observable processes.

skills/ljg-mechanism/SKILL.md
机制说清「谁或什么,在什么条件下,通过哪些中间变化,生成什么结果」。
What is happening here: Provides a rigorous standard definition for mechanisms, closing loopholes where abstract nouns masquerade as explanations.

Preserves competing mechanisms and requires each to specify distinct predictions that could falsify the findings; faithfully retains hypotheses in parallel when indistinguishable.

skills/ljg-mechanism/Workflows/DiscoverMechanism.md
如果各个候选在现有条件下都预测同一结果,暂时无法区分。寻找新的观察位置或条件变化;不以解释更顺口、引用更多作为胜负依据。
What is happening here: Bars post-hoc rationalizations by demanding ex-ante predictions and prohibiting decisions based on writing flair or citation counts.

Expresses evidence strength across four distinct tiers (supported within scope / leading explanation / currently indistinguishable / raw observation needs revision), avoiding link-count or subjective score ratings.

skills/ljg-mechanism/Workflows/DiscoverMechanism.md
**机制在所述范围内有支持**:关键过程有现实依据,因果识别或过程证据足以支撑相应措辞,重要竞争解释得到检验;说明尚存的不确定性。
What is happening here: Establishes a calibrated phrasing benchmark for deliverables, ensuring conclusion strength matches actual empirical backing.

Operates read-only by default without automatically creating notes, reports, logs, rules, or memories; delivers purely deductive reasoning without claiming empirical verification when online search is unavailable.

skills/ljg-mechanism/SKILL.md
研究默认只读,不自动创建笔记、报告文件、日志、规则或记忆。
What is happening here: Decouples "research" from "disk persistence" to avoid unrequested file writes and curbs overclaiming in offline settings.

2Core Capabilities

01Four-step mechanism research framework (Spot Anomalies / Trace Processes / Dissect Explanations / Transfer with Conditions)
02Phenomenon calibration and verification (target, metrics, timeframe, baseline; guards against sample selection bias and denominator shifts)
03Competing explanation management and differential prediction authoring
04Targeted retrieval based on load-bearing dependencies, distinguishing phenomenon, mediator, and causal evidence
05Evidence tiering and boundary articulation (including leading explanations and concrete gaps)
06Conditional transfer and counterfactual reasoning (modifying one key condition to predict what shifts first)
07Example-driven execution: ready-to-use phenomenon research scenarios (stagnant revenue / group Q&A dynamics / technological inefficacy)

3External Dependencies

KindDependency / Endpoint
network联网搜索与正文获取(由宿主 agent 提供,Skill 只声明默认使用,无固定端点)

4Recommended Governance & Evidence

Suggested Controls for Safe Operation
For Agent Runtime
Can be auto-loaded
For Administrators
Register source and version
Evidence & Triggers (File Paths & Excerpts)
  • SKILL.md: Pure prompt instructions and rule text; no script execution or external impact.
Audit Notes: Green, ready to use. Evaluation applies solely to this skill's directory: contains only three text files (SKILL.md, Workflows/DiscoverMechanism.md, and agents/openai.yaml), with zero scripts, zero dependencies, and zero hits for URLs, endpoints, credentials, or file writing (bundle §3 risk scan shows "no hits"). The clause "default to using available web search and web fetch capabilities" declares host environment capabilities rather than packaged outbound code or fixed endpoints, leaving the tier unchanged per evaluation standards. The research workflow is read-only by default, performs no automatic persistence, and accesses no credentials. Rated green.

5Second-Pass Verification

  • [ok] 无脚本、无可执行代码 — §1 清单三文件全为 text(一个 agents/openai.yaml 配置文本);§3「執行外部程序」无命中,grade 依据成立。
  • [ok] 默认只读、不落盘 — SKILL.md 明写「研究默认只读,不自动创建笔记、报告文件、日志、规则或记忆」,并给出用户另行要求保存时的约束;file_writes 为空成立。
  • [ok] 联网为宿主能力而非自带外发 — 正文写「默认使用当前可用的联网搜索与正文获取能力」「联网不可用…说明只完成了推演」,无具体域名/API/脚本调用;§3 网络请求无命中,故 network_calls 为空、不升档。
  • [ok] 功能声明与实际一致(无夸大) — description 的「生成机制猜想,并联网核对现象、检验关键因果与竞争解释,交付…机制及其边界」在正文的检索章节、四档强度与交付检查中均有对应机制,未夸大。
  • [ok] 证据纪律与反自欺条款真实存在 — Gotchas 与「更新与停止」确有「没找到反例不等于通过验证;未显著不等于无效」「不能把看到结果之后补写的预测当成事前验证」等原文。
  • [ok] 注入面复核 — skill 不执行外部内容,只读研究;DiscoverMechanism.md 另要求「搜索查询只携带研究所需的通用信息,不把原始私密材料发送给外部服务」,属隐私防护设计,无命令注入执行面。

6Verdict & Scenarios

  • Defines "mechanisms" as observable processes, stopping the common lazy practice of substituting abstract terms (supply-demand/incentives/systems) for real explanations.
  • Counters post-hoc rationalization via differential predictions and competing explanation management, categorizing conclusion strength across four tiers aligned strictly with evidence.
  • High density of epistemological rigor: boundaries regarding counterexamples, statistically non-significant results, cross-domain analogies, and aggregate vs. individual metrics are embedded in Gotchas to prevent false conclusions.
  • Best for: Ideal for research-oriented users seeking testable explanations for phenomena and willing to accept distinctions like "leading explanation vs. proven fact": product attribution, social phenomena, tech efficacy disputes, exploratory causal mechanisms, etc. Also functions as a thinking template designed to prevent overclaiming.
    Not for: Not suitable for pure conceptual definitions, routine summaries, operational problems with an existing unique solution, or mere landscape mapping (as stated in description's NOT FOR); also unsuitable when absolute certainty is required and parallel explanations or uncertainties are unacceptable.
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload ljg-mechanism.tar.gz
    sha256: a1a66e49d0ea66b0…
    Option B · Copy Guide for Agent
    install.json
    Agents automatically download and verify mirrors from this JSON guide.
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 9e75497a95.