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。