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

ljg-writes

"Writing engine. Turns a viewpoint into an understandable, transferable, and counterexample-resilient Chinese essay of 1,000-1,500 characters. USE WHEN writing essays OR refining thought content OR expanding arguments OR rewriting into logically progressive Chinese. NOT FOR standard summaries, fact lookups, or structural wind tunnel analysis (use ljg-structure instead)."

L4 High-Privilege · Graded auth & full auditV1 Commit-PinnedExecute CommandWrite FileDual-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

Positioned as a writing engine: Explain a viewpoint clearly so that a specific reader understands why it holds and where it applies, defaulting to a 1,000-1,500 character Chinese essay.

skills/ljg-writes/SKILL.md
把一个观点讲清楚,让一个具体的人读懂它为什么成立、能用在哪里。
What is being done here: Setting the writing standard as 'a specific reader being able to recount the underlying relationships'.

Workflow Routing points to the single workflow WriteEssay, fully read upon execution; analysis and checks are performed internally without displaying steps item by item.

skills/ljg-writes/SKILL.md
执行时完整读取工作流。分析和检查在内部完成
What is being done here: Keeping the nine-step analysis internal, presenting only the final results in the body.

Four internal checks for the writing contract: identifiable concepts, operable relationships, mappable cases, and transferable judgments (do not use directly as essay headings).

skills/ljg-writes/SKILL.md
以上四项用于内部检查,不直接用作文章目录。
What is being done here: Treating the contract as a quality inspection checklist rather than a writing template.

Explanatory path: concrete case → existing explanation → unexplained gaps → introducing necessary concepts → reanalyzing the case → explaining complete relationships → checking other scenarios and boundaries.

skills/ljg-writes/SKILL.md
具体案例 -> 原有解释 -> 解释不清的地方…引入所需概念 -> 重新分析案例…说明完整关系 -> 检查其他场景与边界
What is being done here: Using a reusable analytical path to ensure concept introduction is necessary and well-grounded.

Fabricating failures is prohibited: Do not invent deficiencies in existing explanations just to introduce concepts; if an explanation is already sufficient, state the reason directly.

skills/ljg-writes/SKILL.md
不为引出概念编造失败。原有解释的不足必须能在案例、材料或逻辑中找到;
What is being done here: Ensuring that the introduction of concepts is driven by genuine gaps.

Language discipline: Write clearly and plainly, avoiding using 'not... but...' to fabricate rhetorical twists.

skills/ljg-writes/SKILL.md
避免用「不是……而是……」制造转折;事实否定、必要辨析和边界可以保留。
What is being done here: Structuring the text around real relationships rather than syntactic formulas.

Perform two internal tests before drafting in Step 7: transferability (still holds when changing characters/industries/materials) and counterexamples (seemingly identical but does not fit the relationship).

skills/ljg-writes/Workflows/WriteEssay.md
1. *迁移*:换掉人物、行业和表面材料,用同一关系解释一个差异较大的新现象。
What is being done here: Verifying the scope of judgment using transferability and counterexamples.

In Step 9, inspect content first before reading through and polishing the Chinese, and only save the revised complete draft without sentence-by-sentence splicing from two drafts.

skills/ljg-writes/Workflows/WriteEssay.md
只保存修改后的完整稿,不从两稿里逐句挑选、拼成一篇。
What is being done here: Ensuring that the final piece is cohesive as a whole rather than a patchwork of sentences.

In Step 10, generate files according to the Org and Denote contracts; after saving, read back and run Denote acceptance checks and org-lint.

skills/ljg-writes/Workflows/WriteEssay.md
保存后回读全文,检查字数、Org 标题、文件名与 identifier,再运行 Denote 接受检查和 `org-lint`。
What is being done here: Producing an org note that passes Denote acceptance and org-lint validation.

Output constraints: Default total length is 1,000-1,500 characters; defer to the user's length when short revisions/golden quotes/titles are requested; filename format: ~/Documents/notes/{timestamp}==z--{title-keyword}__write.org.

skills/ljg-writes/SKILL.md
总量默认 1000-1500 字;用户明确要短改、金句或标题时服从用户长度。
What is being done here: Fixing length and naming into predictable delivery contracts.

2Core Capabilities

01Turning viewpoints into essays (1,000-1,500 character Chinese essays, adaptable to short revisions/golden quotes/titles)
02Writing contract quality inspection (identifiable concepts / operable relationships / mappable cases / transferable judgments)
03Concept introduction and case mapping inspection
04Diagnosing deficiencies in existing explanations (without fabricating failures)
05Dual internal testing: transferability + counterexamples
06Denote org note generation (including author, identifier, and filetags)
07Chinese text polishing: inspect content first, then read through and revise Chinese, retaining only the final draft
08Disk-write readback with Denote acceptance checks and org-lint execution

4Recommended Governance & Evidence

Suggested Controls for Safe Operation
For Agent Runtime
Graded/per-use authorization, sandbox recommended
For Administrators
Approval workflow, rollback support, full audit
Evidence & Triggers (File Paths & Excerpts)
  • scripts/: Execute local scripts or commands: date +%Y%m%dT%H%M%S and date "+%Y-%m-%d %a %H:%M" (fetching timestamps)
  • 本地工作目录: File I/O and artifact output: ~/Documents/notes/{timestamp}==z--{title-keyword}__write.org (final draft org note)
Audit Notes: Blue: Informational. No external script invocation, no network requests, and no credential reading. Involves only local actions: using date to obtain timestamps, writing org files under ~/Documents/notes/, and performing local verification via Denote acceptance checks and org-lint. Note: The NOT FOR section in description references ljg-structure (structural wind tunnel) in the same repository for division of labor. As a designated external skill, it is noted here only and does not affect the safety tier of this skill itself.

5Second-Pass Verification

  • [ok] 写作引擎定位与字数 — 『总量默认 1000-1500 字』及『把一个观点讲清楚…』原文在。
  • [ok] 工作流路由 — Workflow Routing 指向 Workflows/WriteEssay.md,§1 清单确有该文件。
  • [ok] 四项内部检查 — 『以上四项用于内部检查,不直接用作文章目录。』原文在。
  • [ok] 不编造失败 — 『不为引出概念编造失败。』原文在。
  • [ok] 迁移+反例测试 — Step 7『1. *迁移*:换掉人物、行业和表面材料…』原文在。
  • [ok] Denote 命名与 lint — 『~/Documents/notes/{时间戳}==z--{标题关键词}__write.org』与『运行 Denote 接受检查和 `org-lint`』原文在。
  • [ok] 语言纪律 — 『避免用「不是……而是……」制造转折』原文在。
  • [discrepancy] 风险扫描与内文差异 — 扫描栏『执行外部程序/写盘』报无命中,但正文含 date、Denote/org-lint 与 org 写入;按§2 内文为准,scripts_executed/file_writes 非空。

6Verdict & Scenarios

  • Sets 'a specific person understanding and recounting relationships' as the writing standard, opposing self-indulgent abstract writing.
  • Disciplined concept introduction: diagnoses genuine gaps in existing explanations first and prohibits fabricating failures.
  • Separates internal analysis from external drafting, showing only results in the body so readers do not have to read writing steps.
  • Machine-verifiable disk artifacts: Denote naming + org-lint ensure an objective quality baseline for notes.
  • Best for: Suitable for writing a viewpoint into an understandable, transferable, and counterexample-resilient Chinese essay, or rewriting existing thought fragments with logical progression: essay writing, refining ideas, and expanding viewpoints.
    Not for: Not suitable for standard summaries, factual queries, or structural wind tunnel mechanism analysis; also not suitable for scenarios where only scattered bullet points are desired without forming an essay.
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload ljg-writes.tar.gz
    sha256: a56a231e90e6a60c…
    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.