ワークフロー&基本ツール · lijigang/ljg-skills

ljg-is

名詞や概念を実行可能な理解へと落とし込みます:平易な言葉でそれが何であるか、隣接概念とどう異なるかをまず明確にし、次にどのように機能し、どのような判断を書き換えるのかを説明し、最後に向き合う際のアクションの足がかりを提示します。ユーザーが「Xとは何か」「どう理解すべきか」「何を意味するのか」「なぜ重要なのか」「今後どう判断・活用すべきか」を尋ねた際に使用します。特に技術概念、制度、プロダクト、ロール、手法、仕様、実践に適しています。単なる事実の検索、数式の証明、ステップごとの操作チュートリアル、縦方向の因果関係の深掘り(ljg-thinkを使用)、モチーフ構造(ljg-structureを使用)には適していません。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ファイル書き込みDual-pass Audit
Author lijigangGitHub lijigang/ljg-skills ↗License MIT(仓库根 LICENSE)Commit 9e75497a95
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

中核メカニズム:「何であるか」(名詞)と「どのように機能するか」(動詞)を結びつけ、実行可能な理解へと仕立てる。

skills/ljg-is/SKILL.md
`ljg-is` 把两者接起来:名词回答「它是什么」,让概念在认知地图里站稳;动词回答「它怎样起作用」,让概念在现实里动起来。
ここで行っていること:「名詞の足場を固める + 動詞を動かす」という2段階の結合を文章全体の主軸として用いる。

4つの問いかけは理解に至る道筋であり、本文の見出し項目ではない。

skills/ljg-is/SKILL.md
这四个问题是一条理解路径,不是四个正文栏目。
ここで行っていること:「何であるか/どのように機能するか/認識の是正/行動指針」をチェックリスト的な構造にすることを排する。

趙汀陽の「動詞」の思想は条件付きのレンズであり、必須のプロットではない。

skills/ljg-is/SKILL.md
赵汀阳的「动词」思想在这里仍然重要,但它是一副有条件的透镜。
ここで行っていること:選択者や反作用を追及するのは制度/プラットフォーム/ロールのみであり、技術対象はそれ自体の演算のみを記述する。

Workflow Routingにより、実行をUnderstandInUseワークフロードキュメントに委ねる。

skills/ljg-is/SKILL.md
把「是什么」与「怎样运作」接成可辨认、可判断、可行动的 Org 解读
ここで行っていること:ルーティングテーブルが唯一のワークフローをWorkflows/TraceCreation.mdへとマッピングする。

完成基準として、読者に4つの連続的な変化(位置づけ、メカニズムの再現、従来の判断の是正、具体的行動への落とし込み)を起こすことを求める。

skills/ljg-is/SKILL.md
能用一句普通话说出 X 属于什么,以及它与最容易混淆的对象差在哪里。定义要给边界,不能只给比喻或用途。
ここで行っていること:「理解」を検証可能な4段階に分解し、定義には用途ではなく境界を明示することを義務付ける。

デフォルトの成果物はOrgであり、~/Contextに書き込み、schemaはljg-is-v5に固定する。

skills/ljg-is/SKILL.md
新成品使用 `ljg-is-v5` schema。
ここで行っていること:インデックス作成と検証を容易にするため、永続化パスとバックエンドのメタデータ規約を固定する。

バックエンドの5項目(定義/作動/認識是正/行動判断/根拠と境界)は分析の準備であり、本文の目次ではない。

skills/ljg-is/Workflows/TraceCreation.md
这五件事是分析者的准备,不是正文目录。
ここで行っていること:バックエンドで5項目を明確にすることを求めつつ、本文でのフィールド型見出しや類義語の機械的穴埋めを禁止する。

検収規約:保存後にローカルのBunバリデータ(検証器)を実行し、合格した場合でも必ず全文を読み直す。

skills/ljg-is/Workflows/TraceCreation.md
bun ~/.agents/skills/ljg-is/Tools/ValidateNote.ts "<Org 文件路径>"
ここで行っていること:機械的チェック(6フィールド/見出し/段落数/可読性)と人間による読み戻しを2つのフェーズに分離する。

判断の境界:技術対象に対して架空の創造者を捏造する必要はなく、実際に備えているメカニズムのみを記述する。

skills/ljg-is/SKILL.md
**动词不等于社会创制。** 技术对象可以通过计算、映射、比较、压缩或递归起作用,不必虚构一个创造者故事。
ここで行っていること:技術的な説明を無理に制度批判や哲学的転回へと曲解させるのを防ぐ。

2コア機能

01名詞や概念を実行可能な理解へと落とし込む(何であるか → どのように機能するか → 認識の是正 → アクションの足がかり)
02v5規約に従ってOrgノートを生成し、デフォルトで~/Contextに書き込む
03ローカルバリデータにより、バックエンドの6フィールド、内容に応じた見出し、自然段落数、基礎的な可読性を機械的にチェックする
04フォーマットのアンチパターン(箇条書き、フィールド型見出し、過密な読点・中黒、過剰なセミコロン、極端な長文)を遮断する
05旧来のschema(v2/v3/v4/legacy)との互換読み取りに対応し、過去のノートも継続して検証可能
06添付ファイル/書籍/記事/URL/対話内容を根拠として読み込み、事実と推論を厳密に区別する
074つの読み戻しテスト(名詞/動詞/認識/行動)と末尾のスケール専用チェックを実施する
08失敗境界の処理:定義/メカニズム/認識是正が見出せない場合は、対象を絞り込むか、材料を補充するか、あるいは素朴な状態を維持する

3外部依存関係

KindDependency / Endpoint
clibun(Bun 运行时,执行校验器与自检测试)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • scripts/: ローカルスクリプトまたはコマンドの実行: bun ~/.agents/skills/ljg-is/Tools/ValidateNote.ts "<Org ファイルパス>"(検収規約:保存後に実行、出...
  • 本地工作目录: ファイルの読み書きと成果物の出力: ~/Context/{タイムスタンプ}--理解-{対象フラグメント}__is.org(Template.orgをコピーして生成。ユーザーが明示的に「分析のみ」「保存不要」と指定した場合やrea...
監査ノート: ローカルスクリプト区分:本スキルは独自のBun/TypeScriptバリデータ(Tools/ValidateNote.ts + テスト + Template.org)を内包しています。検収規約としてbunを実行して検証を行い、~/Contextにorgファイルを永続化することが求められるため、「ローカルスクリプト/CLIおよびローカルのファイル読み書きのみ」に該当し、blueと判定されます。スクリプトはnode:pathのみをインポートするプレーンテキストの検証処理であり、ネットワークアクセス、認証情報の利用、サブプロセスのエスケープはありません。スキャンで検知されたURLはテストケース用のexample.comであり、認証情報の検知はテンプレート文字列${...}の埋め込みによる誤検知であるため、いずれも実際の外部呼び出しではなく、評価の引き上げは行いません。

5二重目の独立検証

  • [ok] 两个执行点真实存在 — TraceCreation.md 验收合同给出 bun .../ValidateNote.ts 命令,ValidateNote.help.md 给出同命令与 bun test;脚本首行 #!/usr/bin/env bun。
  • [ok] 脚本无网络/凭证/写盘 — ValidateNote.ts 仅 import { basename } from "node:path",无 fetch/http/fs 写/process.env/child_process;扫描两类命中经核为误报。
  • [discrepancy] 扫描「凭證/環境變數」14 条为误报 — 命中项均为 ValidateNote.test.ts / ValidateNote.ts 里的 JS 模板字符串 ${DEFINITION}、${V3_HEADINGS.join(...)} 等插值,不是环境变量或凭证读取;credential_reads 据实留空。
  • [discrepancy] 扫描「URL/端點」1 条为测试样例 — 唯一命中是 test.ts 用 [网约车](https://example.com) 验证「Org 中出现 Markdown 链接」会被拒,非网络请求;network_calls 留空。
  • [ok] 成品路径与 schema 一致 — SKILL.md 与 TraceCreation.md 一致写 ~/Context/{时间戳}--理解-{目标片段}__is.org,schema 固定 ljg-is-v5、标签 :is:act:。
  • [ok] v5 后台六字段一致 — definition/operation/recognition/guidance/basis/falsifier 在 SKILL.md、help.md、TraceCreation.md、Template.org 与测试中一致。
  • [ok] 判级归属 — 运行 bun 与本地写盘均为本 skill 自身脚本/本地动作,按范式判 blue;无凭证/网络故不升档。

6結論

  • 「理解」を検証可能な4段階のプロセス(定義/メカニズム/認識是正/行動)へと分解し、確定的バリデータと組み合わせてクローズドループを形成する。
  • 汎用的なアドバイスの排除を実行可能なチェックとして組み込み、メカニズム段落を削除しても行動指針が成立してしまう場合は不合格と判定する。
  • バックエンドのフィールドとフロントエンドの文体を分離し、本文でのフィールド型見出しを禁じることで、分析フレームワークが単なるリストとして露出するのを防ぐ。
  • 過去のschema(v2–v5 / legacy)と後方互換性があり、旧ノートの可読性を保ち、既存資産を損なうことなく移行できる。
  • 最適な用途: 技術概念、制度、プロダクト、ロール、手法、仕様を「実践で使えるレベル」まで書き落としたいライターや研究者、特に定義の境界、メカニズム、行動可能な判断基準を重視するorg-modeユーザーに適しています。
    不向きな用途: 以下には適していません:形式的な定義/数式の証明/専門用語の翻訳のみを求める場合、ステップごとの操作チュートリアルを求める場合、縦方向の因果関係の深掘り(ljg-thinkを使用)やモチーフ構造(ljg-structureを使用)が必要な場合、およびbun環境がなくローカルバリデータを実行できないホスト環境。
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload ljg-is.tar.gz
    sha256: 64b38a69ab8a2fac…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 9e75497a95.