docs_build.py¶
pilot docs_build — agents/skills/tools/identity SSOT 를 docs/reference/ 로 추출.
호출: python3 pilot/tools/docs_build.py # 생성 (덮어쓰기) python3 pilot/tools/docs_build.py --check # 생성하지 않고 디스크 상태가 source 와 일치하는지 검증 python3 pilot/tools/docs_build.py --root PATH # 다른 pilot 디렉토리에 대해 실행 (기본: 본 파일 기준 자동 탐지)
입력: {root}/agents/.md {root}/skills//SKILL.md {root}/tools/*.py # docstring 만 추출 (CLI --help 캡처는 별도 단계) {root}/skills/context/shared/identity.yml
출력: {root}/docs/reference/agents/{name}.md {root}/docs/reference/skills/{name}.md {root}/docs/reference/tools/{tool_stem}.md {root}/docs/reference/identity.md
Exit: 0 — 성공 1 — --check 모드에서 drift 발견 또는 입력 디렉토리 누락