Research Artifacts (연구 결과물)
연구는 의사 결정의 근거가 되는 외부 증거(기술 평가, 라이브러리 비교, 업계 관행 조사)를 기록합니다. 연구는 날짜, 출처, 추가 전용 방식으로 작성되며, 특정 시점의 증거를 보여주는 스냅샷으로, 지속적으로 변하는 의견이 아닙니다.
이 스킬은 연구가 구성되고, 서식이 지정되며, 색인화되는 방식을 정의합니다. deep-research 스킬은 연구를 수집하고 교차 검증하는 방법을 정의하며, living-docs는 연구가 제공하는 결정과 이슈를 관리합니다. 세 가지는 함께 구성됩니다. 연구 결과물은 OKF 개념입니다. 여기에 적용된 frontmatter/예약 파일 규칙에 대해서는 okf-knowledge-format 스킬을 참조하십시오.
이 스킬 사용하기 (점진적 정보 공개)
이 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. - 초안에 출처 규율(1차 출처, vendor-COI 플래그, 추론 대 사실 레이블, 신뢰 수준, 가져오기 실패 메모)을 적용할 때 —
living-docs guide rules --skill research-artifacts. - 연구→결정→이슈 추적 체인을 연결할 때 (수용된 권장 사항은 ADR에 도달한 후
living-docs의 이슈로 이어져야 함) —living-docs guide structure --skill research-artifacts.