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

ljg-qa

情報発問エンジン。記事、論文、書籍から核心的な主張を抽出し、Q-Aペアへと再構築します。Questionは要点を鋭く突き、教科書的な問いを排除。Answerは簡潔明瞭で、形式化された結びと完全な論理チェーンを備えます。読者がQの連鎖を辿ることで、各Aが楔のように打ち込まれ、著者の推論全体が再現されます。ユーザーが「问答」「Q&A」「QA」「提问」「抽取问题」「/ljg-qa」と発言した場合、または記事・論文・書籍を共有してQ-A抽出を求めた場合に使用します。要約ではなく、一連の鋭い問いと回答を通じて思想を抽出したい場合にトリガーされます。FAQ生成、用語集作成、読解クイズ用ではありません — 本機能は学習補助ではなく、知的足場架設のためのものです。

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

1仕組みと動作原理

記事・論文・書籍を「なぜ—どのように—境界」の問答チェーンとして読み解き、単なる要約ではなく思考の骨格を再構築する

skills/ljg-qa/SKILL.md
读一份东西,把它的思想拆成「为什么—怎么—边界」的问答链。
ここでの目的:基調の設定 — 成果物は問答チェーンであり、QとAそれぞれに厳格な制約を課す。FAQや体裁を変えただけの要約は作成しない

Qは核心を突くこと、Aは厳格な4段落構成で形式化して締めくくること、Qチェーンには方向性を持たせることという3つの鉄則を規定する

skills/ljg-qa/SKILL.md
*A 有形式化收口* —— 每个 A 严格四段:*结论*(一句话)+ *形式化*(用文字 + 简单符号把思想压成一行可视关系,如 `A = B + C`、`旧: X → 新: Y`)+ *论证步*(怎么想到的)+ *边界*(不成立的条件)。
ここでの目的:「思想の抽出」を検証可能なフォーマット規約に落とし込み、特にAの厳格な4段落構成を徹底する

Step 2 まず背骨を立てる:核心となる論点と3〜5箇所の決定的な転換点を書き出し、Qチェーンの骨格とする

skills/ljg-qa/Workflows/Extract.md
这篇东西的核心论点是什么?它怎么把这个论点撑起来?哪几步是关键转折?
ここでの目的:Qチェーンを著者の論証の背骨にアンカーさせる。背骨が立たなければ再読する

Qの順序は章立ての順番ではなく論証の依存関係に従う:まず根本的な問題を問い、次に解決策を、その後に代償を問う

skills/ljg-qa/Workflows/Extract.md
按论证依赖关系,不按章节顺序。原文先写背景再写方法是叙事需要,但 Q 链应该按「先问根问题,再问解法,再问代价」走。
ここでの目的:「依存関係」を利用して、Qチェーンを目次的な羅列から論理的な推論経路へと変換する

Aに対する4段落の厳格な要件:再利用可能な結論、1行で可視化された形式化、1ステップのみの論証、成立しない条件のみを記した境界

skills/ljg-qa/Workflows/Extract.md
*边界*:写「不成立的条件」,不写「未来工作」——前者是诚实度,后者是公关辞令
ここでの目的:「境界」と「短所」を切り離し、反証可能な適用条件を明確に引き出す

Step 5 削除テストでQチェーンの方向性を確認:1つ削除すると後続が破綻する場合のみ正規の経路とみなし、そうでなければ並べ替えや統合を行う

skills/ljg-qa/Workflows/Extract.md
如果 Q 之间是平行的(删一个不影响其他),重排或合并。Q 链是路径,不是清单。
ここでの目的:削除テストを用いてQチェーンの因果的依存関係を検証する

出力はorg-modeを強制(markdown構文は禁止)し、denote仕様に従って命名・保存する

skills/ljg-qa/SKILL.md
denote 文件名:`{YYYYMMDDTHHMMSS}--qa-{核心主题 5-10 字}__qa.org`
ここでの目的:出力フォーマットと命名規則を固定し、ノートシステム内でタグによる検索を容易にする

Qを「動・対・因・界」の4種類に分類。優れたQチェーンは少なくとも3種類を混在させる必要があり、そうでなければチュートリアル/討論原稿/論文/振り返りへと退化する

skills/ljg-qa/References/QuestionDesign.md
纯动作问题 = 教程 … 只有混合,才能复刻原作那种「方法 + 代价 + 限制」的真实张力。
ここでの目的:タイプの混合により「手法+代償+制約」というリアルな緊張感を維持する

Qの禁止事項リストを提示(「Xとは何か」「手順はいくつあるか」「重要か」「メリット・デメリット」「将来にとって何を意味するか」など)

skills/ljg-qa/References/QuestionDesign.md
❌ 「什么是 X?」 —— 一句定义打发,没承重
ここでの目的:教科書的あるいはビジネススクール的な常套句の問いが生成されるのを防ぐ

GotchasとしてAIの典型的な失敗パターンを事前提示:教科書的な口調、散漫なA、章ごとの機械的な発問、無難を狙った専門用語の羅列

skills/ljg-qa/SKILL.md
*AI 默认会写「什么是 X」型问题* —— 教科书腔。生成后扫一遍,凡是 Q 能用一句定义打发的,重写
ここでの目的:よくある品質劣化を想定し、手戻り修正アクションを定義する

2コア機能

01記事/論文/書籍から5〜10個の方向性を持ったQ-Aチェーンを抽出
02Qの4つの設計テンプレート(動作/対比/因果/境界)
03Aの厳格な4段落フォーマット(結論/形式化/論証ステップ/境界)
04形式化された4つの結びパターン(等式/対比/フロー/漸進)
05Qのトーン書き換え:学術調を口語表現に変換、Qは20文字以内
06Qチェーンのトポロジカルソートと下書き(順不同=FAQ、依存関係あり=推論経路)
07複数ソースからのコンテンツ取得(URL/arxiv/PDF/直接テキスト/論文・書籍名)
08org-mode denoteファイル命名規則と構造(タイトル/導入/Q/結び)
09納品前セルフチェックリスト(Qの支持力、Aの4段構成、形式化の可視化、学術調の排除)

3外部依存関係

KindDependency / Endpoint
network本地 Voice Notification 端点(workflow 执行前通知)
api宿主网页/文件获取能力(WebFetch / WebSearch / Read)

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

安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
  • 本地工作目录: ファイルの読み書きおよび成果物の出力: エージェントが出力規約に従い ~/Documents/notes/{YYYYMMDDTHHMMSS}--qa-{主題}__qa.org に書き込み(org-mo
監査ノート: 判定はスキル自身のディレクトリ(skills/ljg-qa/ = SKILL.md + References/QuestionDesign.md + Workflows/Extract.md、すべてMarkdown形式であり、スクリプト/バイナリ/隠しファイルは一切なし)のみに基づいて行われます。実行可能コードはゼロ、認証情報の読み取りはゼロ、外部ネットワークエンドポイントはゼロです。ディレクトリ内に記載されている curl -s -X POST http://localhost:31337/notify(ローカルループバック通知)および ~/Documents/notes/ への書き込みは、すべて SKILL.md がエージェントホストに指示するアクションであり、判定基準上はホスト側の挙動とみなされるため、評価レベルに影響はありません。

5二重目の独立検証

  • [ok] 实现原理=纯 prompt 编排,无自带可执行代码 — 全目录 3 个文件均为 Markdown(SKILL.md / References/QuestionDesign.md / Workflows/Extract.md);扫描到的『执行外部程序』只有 SKILL.md 与 Extract.md 各一段 curl 本地通知,无其他脚本。
  • [ok] Voice Notification 的 curl 调用真实存在且指向本地回环 — SKILL.md 与 Workflows/Extract.md 各有一段完全相同的 curl -s -X POST http://localhost:31337/notify 命令块,端点仅 localhost,不含任何外部域。
  • [ok] 输出路径与命名在 SKILL.md 与 Extract.md 间一致 — 两处都写 ~/Documents/notes/ 与 {YYYYMMDDTHHMMSS}--qa-{主题}__qa.org,denote 前缀 qa- 与后缀 __qa 一致,无冲突。
  • [ok] 「5-10 个 Q」数量纪律前后一致 — SKILL.md 未给数量;QuestionDesign.md「数量节制」与 Extract.md Step 3 均为 5-10 个 Q、7±2 最舒服,彼此不冲突。
  • [ok] 形式化禁 LaTeX、禁 Unicode 绘图的约束可执行 — QuestionDesign.md 明列允许符号 = ≠ → ← + - × ÷ < > ⊃ ⊂ ⊥ ∧ ∨,禁 LaTeX 与复杂运算式,并给等式/对比/流向/递进四模式与『单独抽出来能否看懂』的检验句,可判定。
  • [discrepancy] 风险扫描把正文示例词 token 误报为凭据命中 — §3「憑證/環境變數」5 条命中全部是正文里的『token 经济性』『数据 → token → 答案』等示例词,无任何环境变量或密钥读取;扫描为线索非结论,故 credential_reads 保持空。
  • [ok] meta 直采项(stars/installs)无可定位 per-skill 值 — §0 未给 stars/last_push;安装量只有仓库级聚合,按契约 meta.stars / last_push / installs 保持 null。

6結論

  • 「思想の抽出」をセルフチェック可能なフォーマット規約に定着:Qは要点を突き、Aは厳格な4段落、Qチェーンは論証の依存関係に沿って並べ、各ステップに対照例リストを付与
  • 成果物がそのまま利用可能:org-mode出力 + denote命名規則により、~/Documents/notes/ に保存するだけでノートシステムから即座に検索可能
  • 学術的背景と深みを持つ手法:『学習観』的な判別/結合モデルの思考を取り入れ、4つの形式化パターンと「抽出後に理解可能か」を検証する判定文を完備
  • AI特有の品質劣化(教科書調、章ごとの発問、専門用語による無難な逃げ)を予測し、生成後の強制的な手戻り修正を要求
  • 最適な用途: 適した用途:長文記事・論文・書籍の論証骨格を辿りやすいQ-Aチェーンとして抽出し、ローカルノートシステム(denote)に保存したい執筆者。読書のアウトプットを単なる要約から推論の再現へとアップグレードしたいシナリオ。
    不向きな用途: 適さない用途:FAQ、用語集、読解問題といった学習補助教材を求めている場合、手軽な要約のみを目的とする場合、またはノートを作成せず出力ファイルを必要としない一時的な質疑応答。
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload ljg-qa.tar.gz
    sha256: 1b797a9697841e58…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 9e75497a95.