* feat(i18n): add multilingual wiki scaffolding, language switcher, and translation QA pipeline * docs(readme): adopt picoclaw-style multilingual link bar * fix(i18n): repair localized index links and tighten partial-pair QA * ci(i18n): fail on broken markdown links in README/wiki * ci(i18n): add changed-files mode for markdown link checks * i18n(de): use local Argos MT to fill untranslated German sections * i18n(es,fr): fill untranslated sections via local Argos workflow * i18n(ja): fill untranslated sections with scoped local Argos pass * i18n(ko): fill untranslated sections with scoped local Argos pass * fix(i18n): address review feedback --------- Co-authored-by: David Abutbul <David.a@prompt.security>
4.6 KiB
작업 흐름
엔드 투 엔드 라이프 사이클
- 개발은 로컬 코딩 + 실시간 UI 미리보기를 위한 로컬 데이터 인구로 시작합니다.
- PR CI는 품질/보안 및 기술 테스트 제품군을 검증합니다.
- PR Pages-verify는 출판하지 않고 생산 빌드 / 서명 동작을 검증합니다.
- Tag-driven release 워크플로우 패키지 및 표지 기술 artifacts.
- 페이지 배치 작업 흐름 미러 출시 / 자문 artifacts 및 정적 사이트 게시.
- Wiki-sync 워크플로우는
wiki/docs를main에 게시합니다. - 지속적으로 Enrich 자문 피드 및 공급망 가시성을 계획했습니다.
일류 지도
| 워크 플로우 | 트리거 | 메인 스테이지 |
인포메이션
| CI | PR/push to main | Lint, typecheck, build, Python checks, 보안 검사, 기술 테스트. ·
· 페이지 Verify | PR to main | 페이지 작성 및 유효성 표시 출력 (포토 없음). ·
| Poll NVD CVEs | 일일 크론 + 수동 파견 | Fetch CVE, transform/dedupe, update feed, sign artifact, PR changes. ·
| Process Community Advisory | 이슈 라벨 advisory-approved | 파스 이슈 양식, 자문, 서명 피드, 열린 PR, 코멘트 발행. ·
| 기술 자료 | 기술 태그 + 메타데이터 PR 변경 | PR: version-parity + Dry-run checks; 태그: 패키지/sign/publish release Asset. ·
| 배포 페이지 | 성공적인 CI/리엘리스 또는 수동 파견 | 출시, 미러 자산, 서명 공개 자문/체크섬, 배포 사이트. ·
| Sync Wiki | main 터치 wiki/** + 수동 파견 | wiki/를 <repo>.wiki.git로 동기화하고 Home.md를 INDEX.md로 생성합니다. ·
로컬 연산자 Workflow
| 단계 | 명령 | 결과 |
인포메이션
| 설치 deps | npm install | 현지 환경 ·
| 현지 카탈로그 | ./scripts/populate-local-skills.sh | public/skills/index.json 및 파일 체크섬. ·
| 현지 피드를 Populate | ./scripts/populate-local-feed.sh --days 120 | 현지 대리점의 공급 사본을 업데이트했습니다. ·
| wiki llms 수출 | npm run gen:wiki-llms | 업데이트 public/wiki/llms.txt 및 페이지 수출. ·
| 런 로컬 게이트 | ./scripts/prepare-to-push.sh | CI-like pass/fail 신호. ·
| start dev UI | npm run dev | 현지 Vite 엔드포인트의 브라우저 미리보기. ·
# # # # # # # # # 공지사항
- 버전 범프 및 문서 패성은 PR / 태그 경로에 적용됩니다.
- 기술 포장에는 SBOM-declared 파일과 무결성가 나타납니다.
checksums.json는 워크플로우 실행에서 즉시 확인됩니다.- 선택된 게시-to-ClawHub 작업은 구성될 때 성공적인 GitHub 릴리스 후 실행됩니다.
- 같은 주요 라인 내의 이전 릴리스는 자동화에 의해 superseded/deleted 수 있습니다.
자문 작업 흐름 세부
- NVD 워크플로는 이전 피드
updated타임스탬프에서 증가된 창을 결정합니다. - 변형 단계지도 CVE 메트릭은 severity/type에 따라 영향을 받는 표적을 정상화합니다.
- 커뮤니티 자문 워크플로는 문제 메타데이터에서 deterministic ID (
CLAW-YYYY-NNNN)를 생성합니다. - 두 권의 워크플로우 업데이트 기술 피드 복사 및 서명 동반자.
예제 Snippets
# manual release prep for a skill
./scripts/release-skill.sh clawsec-feed 0.0.5
# then push tag if running in release branch mode
# pages deploy depends on successful upstream workflow run
on:
workflow_run:
workflows: ["CI", "Skill Release"]
types: [completed]
운영 위험
- Workflow 권한 및 비밀 범위 misconfiguration는 signing/publishing을 차단할 수 있습니다.
- NVD/API 일시적인 실패는 자문 신선도를 지연할 수 있습니다.
- 잘못된 태그 naming 또는 버전 mismatches halt 릴리스 자동화.
- 로컬 스크립트 및 CI는 연산자 기계가 예상되는 binaries (
jq,openssl,clawhub)가 부족한 경우 다이브레이터 할 수 있습니다.
소스 참조
- 스크립트/출시-skill.sh
- 스크립트/prepare-to-push.sh
- 스크립트/populate-local-feed.sh
- 스크립트/populate-local-skills.sh
- 스크립트/generate-wiki-llms.mjs
- .github/workflows/ci.yml의 경우
- .github/workflows/poll-nvd-cves.yml의 경우
- .github/workflows/community-advisory.yml
- .github/workflows/skill-release.yml의 경우
- .github/workflows/deploy-pages.yml의 경우
- .github/workflows/페이지-verify.yml
- .github/workflows/wiki-sync.yml의 경우
- .github/workflows/codeql.yml의
- .github/workflows/scorecard.yml의 경우
- .github/actions/sign-and-verify/action.yml