Community研究與資料分析github.com

ejklock/research-artifacts

以 OKF 相容的知識捆綁包(知識束)來組織、格式化與索引研究資料 — 包含日期、來源,且僅可追加的決策外部證據快照。

research-artifacts 是什麼?

Research Artifacts 是用於記錄、結構化與索引外部研究證據(如技術評估、函式庫比較、業界實務調查)的技能。它將研究輸出儲存為 OKF(開放知識格式)相容的知識捆綁包,確保每筆記錄都具備日期戳記、來源標註,且為僅可追加(append-only)的不可變快照。此技能專注於**組織、格式化與索引**階段,而 `deep-research` 負責蒐集與交叉驗證證據,`living-docs` 則負責管理由此產生的決策與議題。本 SKILL.md 為輕量路由器,實際規則(如來源紀律、推論 vs 事實標籤、可信度等級、研究→決策→議題可追溯鏈)需透過 `living-docs guide --skill research-artifacts` 指令動態載入不同主題。支援的 CLI 主題包含:rules、structure、research-report、research-index、research-general-references 與 about。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ejklock/living-docs-skill/tree/HEAD/skills/research-artifacts

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Research Artifacts

研究記錄了決策背後的外部證據:技術評估、函式庫比較、業界實務調查。研究是包含日期、來源,且僅可追加的 — 這是在某個時間點上,證據所呈現內容的快照,而非動態觀點。

此技能定義了研究如何組織、格式化與索引。deep-research 技能定義了如何蒐集與交叉驗證;living-docs 則擁有它所產生的決策與議題。三者相互組合。研究工件是 OKF 概念 — 請參閱 okf-knowledge-format 技能以了解此處適用的 frontmatter/保留檔案規則。


使用此技能(漸進揭露)

本 SKILL.md 是一個輕量存根 — 一個觸發器加上任務→主題路由器。living-docs CLI 存放完整的研究規則、來源紀律、結構與可追溯鏈,並以漸進方式揭露這些內容。在進行任何撰寫之前,請為你的任務載入主題:

  • living-docs guide --list — 探索所有主題。
  • living-docs guide <topic> --skill research-artifacts — 載入該主題。

管線輸出預設為最小化的 JSON(機器預設);使用 --plain 取得人類可讀文字,使用 --json 強制輸出 JSON。主題包含:rules、structure、research-report、research-index、research-general-references、about。

這個存根是一個純路由器(ADR 0017):它觸發並指向主題,本身不含內聯規則。來源紀律以及研究→決策→議題鏈皆為主題,需在撰寫前透過 guide rules --skill research-artifacts / guide structure --skill research-artifacts 載入。


何時呼叫

  • 將研究階段的輸出記錄到 docs/research/ — living-docs guide research-report --skill research-artifacts。
  • 結構化或索引研究筆記(docs/research/NNNN-<slug>.md + 索引列表 + 總覽彙整) — 使用 living-docs guide research-index --skill research-artifacts / guide research-general-references --skill research-artifacts 取得範本,使用 guide structure --skill research-artifacts 取得佈局規則。
  • 對草稿強制執行來源紀律(主要來源、供應商利益衝突標記、推論 vs 事實標籤、可信度等級、擷取失敗備註) — living-docs guide rules --skill research-artifacts。
  • 建立研究→決策→議題可追溯鏈(被接受的建議必須進入 ADR,然後進入議題,均在 living-docs 中) — living-docs guide structure --skill research-artifacts。

相關技能