mirror of
https://github.com/prompt-security/clawsec.git
synced 2026-06-21 17:31:22 +03:00
David Abutbul
b37162a33d
* 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>
88 lines
4.6 KiB
Markdown
88 lines
4.6 KiB
Markdown
<!-- AUTO-GENERATED TRANSLATION SCAFFOLD (ko)
|
|
Source: ../workflow.md
|
|
Review status: draft
|
|
-->
|
|
|
|
# 작업 흐름
|
|
|
|
## 엔드 투 엔드 라이프 사이클
|
|
- 개발은 로컬 코딩 + 실시간 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
|
|
```bash
|
|
# manual release prep for a skill
|
|
./scripts/release-skill.sh clawsec-feed 0.0.5
|
|
# then push tag if running in release branch mode
|
|
```
|
|
|
|
```yaml
|
|
# 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
|