+ClawSec: Security Skill Suite für KI-Agenten
+
+
+ClawSec: Security Skill Suite für KI-Agenten
+
+
+
+
+ClawSec: Suite de compétences en sécurité pour les agents d'IA
+
+
+
+
+ClawSec:AIエージェントのセキュリティスキルスイート
+
+
+
+wiki/.
This is the same source synced to GitHub Wiki.
+ --dry-run
+```
+
+Create missing pages for a language:
+```bash
+python scripts/i18n/bootstrap_language_from_en.py --lang
+```
+
+Overwrite existing scaffolds if needed:
+```bash
+python scripts/i18n/bootstrap_language_from_en.py --lang --overwrite
+```
+
+Convenience npm scripts:
+```bash
+npm run i18n:bootstrap:ko
+npm run i18n:bootstrap:fr
+npm run i18n:bootstrap:de
+npm run i18n:bootstrap:ja
+```
+
+## What QA checks
+- Fenced code blocks are preserved exactly from source.
+- Critical inline technical tokens are preserved.
+- Absolute URLs from source still exist in translation.
+- Non-translatable product/skill terms remain unchanged.
+
+## CI integration
+Workflow: `.github/workflows/i18n-qa.yml`
+
+Runs on PRs that touch:
+- `README*.md`
+- `wiki/**/*.md`
+- `scripts/i18n/**`
+- `.github/workflows/i18n-qa.yml`
+
+## Translation backend strategy (local/free-first)
+Recommended approach:
+1. Local model for draft translation (NLLB/Marian via CTranslate2 or LibreTranslate self-hosted)
+2. Free API fallback for difficult segments
+3. Human review for high-impact docs (README, install, security pages)
+
+## Rollout notes
+- Add new language under `wiki//` and `README..md`.
+- Add language option in `pages/WikiBrowser.tsx` label map when introducing a new language code.
+- Update `translation-tracker.md` for new pages.
diff --git a/wiki/i18n/terminology-en-es.md b/wiki/i18n/terminology-en-es.md
new file mode 100644
index 0000000..0281294
--- /dev/null
+++ b/wiki/i18n/terminology-en-es.md
@@ -0,0 +1,29 @@
+# Terminology Lock (EN -> ES)
+
+Use these canonical translations for consistency across README and wiki translations.
+
+| English term | Spanish standard | Notes |
+| --- | --- | --- |
+| advisory | advisory | Keep as borrowed technical term in this repo context. |
+| advisory feed | feed de advisories | Keep "feed" and "advisories" for consistency with existing docs. |
+| signed advisory feed verification | verificación de feed firmado de advisories | Preserve security meaning; do not simplify. |
+| drift detection | detección de drift | Keep "drift" literal in technical context. |
+| file integrity | integridad de archivos | |
+| supply-chain install verification | verificación de instalación de cadena de suministro | |
+| fail-closed verification | verificación fail-closed | Keep fail-closed in English. |
+| baseline | baseline | Keep baseline in English in this context. |
+| security posture | postura de seguridad | |
+| self-pen-testing | self-pen-testing | Keep package naming term unchanged. |
+| release artifact | artefacto de release | Keep "release" term in English. |
+| source of truth | fuente de verdad | |
+| quick start | inicio rápido | |
+| workflow | workflow | Keep in most headings to match established wiki naming. |
+
+## Non-translatable terms
+Always preserve exactly:
+- Product/platform names: `ClawSec`, `OpenClaw`, `NanoClaw`, `Hermes`, `Picoclaw`
+- Skill package names: `clawsec-suite`, `clawsec-feed`, etc.
+- File names, paths, env vars, commands, and flags
+
+## Review rule
+If a translator proposes a different term, update this file in the same PR before merging.
diff --git a/wiki/i18n/translation-tracker.md b/wiki/i18n/translation-tracker.md
new file mode 100644
index 0000000..508fb0e
--- /dev/null
+++ b/wiki/i18n/translation-tracker.md
@@ -0,0 +1,62 @@
+# Translation Tracker
+
+Track translation coverage and freshness versus English source docs.
+
+_Last updated: 2026-04-27_
+
+## README Coverage
+
+| Source | Spanish | Status | Notes |
+| --- | --- | --- | --- |
+| `README.md` | `README.es.md` | partial | Covers onboarding + operations + local dev. Advanced schema/CI details stay in EN for now. |
+| `README.md` | `README.ko.md` | partial | Korean scaffold with quickstart and core navigation; advanced details remain in EN. |
+
+## Wiki Coverage (ES)
+
+| Source page | Spanish page | Status |
+| --- | --- | --- |
+| `wiki/INDEX.md` | `wiki/es/INDEX.md` | done |
+| `wiki/overview.md` | `wiki/es/overview.md` | done |
+| `wiki/localization.md` | `wiki/es/localization.md` | done |
+| `wiki/architecture.md` | — | pending |
+| `wiki/security.md` | `wiki/es/security.md` | done |
+| `wiki/configuration.md` | — | pending |
+| `wiki/testing.md` | — | pending |
+| `wiki/workflow.md` | — | pending |
+
+## Wiki Coverage (KO)
+
+| Source page | Korean page | Status |
+| --- | --- | --- |
+| `wiki/INDEX.md` | `wiki/ko/INDEX.md` | done |
+| `wiki/overview.md` | `wiki/ko/overview.md` | partial |
+| `wiki/security.md` | `wiki/ko/security.md` | done |
+| `wiki/localization.md` | `wiki/ko/localization.md` | done |
+| `wiki/configuration.md` | `wiki/ko/configuration.md` | done |
+
+## Wiki Coverage (FR/DE/JA)
+
+| Language | Coverage status | Notes |
+| --- | --- | --- |
+| `fr` | scaffolded | Auto-generated draft scaffolds for all current wiki pages. |
+| `de` | scaffolded | Auto-generated draft scaffolds for all current wiki pages. |
+| `ja` | scaffolded | Auto-generated draft scaffolds for all current wiki pages. |
+
+## Phase Plan
+
+### Phase 1 (completed)
+- Establish translation baseline:
+ - `README.es.md`
+ - `wiki/es/INDEX.md`
+ - `wiki/es/overview.md`
+
+### Phase 2 (in progress)
+- Establish localization process:
+ - `wiki/localization.md`
+ - `wiki/es/localization.md`
+ - terminology lock
+ - translation tracker
+
+### Phase 3 (next)
+- Expand translated wiki coverage for security/operator pages.
+- Add second language pilot (recommended: French or German).
diff --git a/wiki/ja/GENERATION.md b/wiki/ja/GENERATION.md
new file mode 100644
index 0000000..d566ca6
--- /dev/null
+++ b/wiki/ja/GENERATION.md
@@ -0,0 +1,42 @@
+
+
+# Wiki Generation Metadata
+
+- Commit hash: `c3983a100581a9f27eb8cc3b5baa4f585e6c45e4`
+- Branch name: `codex/clawsec-scanner-0.0.2-dast-harness`
+- Generation timestamp (local): `2026-03-10T19:06:29+0200`
+- Generation mode: `update`
+- Output language: `English`
+- Assets copied into `wiki/assets/`:
+ - `overview_img_01_prompt-security-logo.png` (from `img/Black+Color.png`)
+ - `overview_img_02_clawsec-mascot.png` (from `public/img/mascot.png`)
+ - `architecture_img_01_prompt-line.svg` (from `public/img/prompt_line.svg`)
+
+## Notes
+- Migrated root documentation pages from `docs/` into dedicated `wiki/` operation pages.
+- Updated index and cross-links to use `wiki/` as the documentation source of truth.
+- Added a dedicated module page for `clawsec-scanner` and linked it from `wiki/INDEX.md`.
+- Future updates should preserve existing headings and append `Update Notes` sections when making deltas.
+- 2026-04-15: Expanded `wiki/modules/hermes-attestation-guardian.md` into full narrative claim breakdowns (people-speak + wiring + verification + scenario) and moved draft-plan context into `wiki/modules/hermes-attestation-guardian-draft-history.md`.
+- 2026-04-26: Split Picoclaw self-pen-testing into dedicated `wiki/modules/picoclaw-self-pen-testing.md`, and updated `wiki/modules/picoclaw-security-guardian.md` to cover advisory/drift/supply-chain scope only.
+- 2026-04-25: Added DeepWiki-friendly `wiki/modules/picoclaw-security-guardian.md` with support-matrix claims, threat model, default safety posture, frontend/advisory-board wiring, verification commands, and source references. Regenerated `public/wiki/**/llms.txt` exports with `npm run gen:wiki-llms`.
+
+## Source References
+- README.md
+- package.json
+- AGENTS.md
+- wiki/overview.md
+- wiki/architecture.md
+- wiki/modules/clawsec-scanner.md
+- wiki/modules/picoclaw-security-guardian.md
+- wiki/modules/picoclaw-self-pen-testing.md
+- wiki/dependencies.md
+- wiki/data-flow.md
+- wiki/glossary.md
+- wiki/security-signing-runbook.md
+- wiki/migration-signed-feed.md
+- wiki/platform-verification.md
+- wiki/remediation-plan.md
diff --git a/wiki/ja/INDEX.md b/wiki/ja/INDEX.md
new file mode 100644
index 0000000..2993d4e
--- /dev/null
+++ b/wiki/ja/INDEX.md
@@ -0,0 +1,82 @@
+
+
+# Wiki Index
+
+## Summary
+- Purpose: Document ClawSec as a combined web catalog, signed advisory channel, and multi-skill security distribution system.
+- Tech stack: React 19 + Vite + TypeScript frontend, Node/ESM scripts, Python utilities, Bash automation, GitHub Actions pipelines.
+- Entry points: `index.tsx`, `App.tsx`, `scripts/prepare-to-push.sh`, `scripts/populate-local-feed.sh`, `scripts/populate-local-skills.sh`, workflow files under `.github/workflows/`.
+- Where to start: Read [Overview](overview.md), then [Architecture](architecture.md), then module pages for the area you are editing.
+- How to navigate: Use Guides for cross-cutting concerns, Operations for runbooks and migration plans, Modules for implementation boundaries, and Source References at the end of each page to jump into code.
+
+## Start Here
+- [Overview](overview.md)
+- [Architecture](architecture.md)
+
+## Translations
+- [Español](../es/INDEX.md)
+- [한국어](../ko/INDEX.md)
+
+## Guides
+- [Localization Workflow](localization.md)
+- [Dependencies](dependencies.md)
+- [Data Flow](data-flow.md)
+- [Configuration](configuration.md)
+- [Testing](testing.md)
+- [Workflow](workflow.md)
+- [Security](security.md)
+
+## Operations
+- [Security Signing Runbook](security-signing-runbook.md)
+- [Signed Feed Migration Plan](migration-signed-feed.md)
+- [Platform Verification Checklist](platform-verification.md)
+- [Cross-Platform Remediation Plan](remediation-plan.md)
+
+## Modules
+- [Frontend Web App](../modules/frontend-web.md)
+- [ClawSec Suite Core](../modules/clawsec-suite.md)
+- [ClawSec Scanner](../modules/clawsec-scanner.md)
+- [Hermes Attestation Guardian](../modules/hermes-attestation-guardian.md)
+- [Hermes Attestation Guardian Draft History (Archived)](../modules/hermes-attestation-guardian-draft-history.md)
+- [NanoClaw Integration](../modules/nanoclaw-integration.md)
+- [Picoclaw Security Guardian](../modules/picoclaw-security-guardian.md)
+- [Picoclaw Self Pen Testing](../modules/picoclaw-self-pen-testing.md)
+- [Automation and Release Pipelines](../modules/automation-release.md)
+- [Local Validation and Packaging Tools](../modules/local-tooling.md)
+
+## Glossary
+- [Glossary](glossary.md)
+
+## Generation Metadata
+- [Generation Metadata](GENERATION.md)
+
+## Update Notes
+- 2026-04-26: Split Picoclaw self-pen-testing into standalone `picoclaw-self-pen-testing`; updated Picoclaw module docs and references.
+- 2026-04-25: Added Picoclaw Security Guardian module for advisory awareness, config drift detection, and chain-of-supply verification.
+- 2026-04-19: Moved NanoClaw platform-support and CI/CD pipeline detail sections out of `README.md` into module pages (`modules/nanoclaw-integration.md`, `modules/automation-release.md`) and left README pointers.
+- 2026-04-16: Added install-guard compatibility note for Hermes Attestation Guardian (community-source install now SAFE without `--force`; behavior unchanged).
+- 2026-04-15: Expanded Hermes Attestation Guardian module page into full narrative, claim-by-claim operator guidance (no claim tables), and added archived draft-history module page.
+- 2026-03-10: Added ClawSec Scanner module documentation and linked it under Modules.
+- 2026-02-26: Added Operations pages and updated navigation guidance after migrating root docs into wiki pages.
+
+## Source References
+- README.md
+- App.tsx
+- package.json
+- scripts/prepare-to-push.sh
+- scripts/populate-local-feed.sh
+- scripts/populate-local-skills.sh
+- skills/clawsec-suite/skill.json
+- skills/clawsec-scanner/skill.json
+- skills/hermes-attestation-guardian/skill.json
+- skills/picoclaw-security-guardian/skill.json
+- skills/picoclaw-self-pen-testing/skill.json
+- wiki/modules/clawsec-scanner.md
+- wiki/modules/hermes-attestation-guardian.md
+- wiki/modules/hermes-attestation-guardian-draft-history.md
+- wiki/modules/picoclaw-security-guardian.md
+- wiki/modules/picoclaw-self-pen-testing.md
+- .github/workflows/ci.yml
diff --git a/wiki/ja/architecture.md b/wiki/ja/architecture.md
new file mode 100644
index 0000000..f85a3df
--- /dev/null
+++ b/wiki/ja/architecture.md
@@ -0,0 +1,136 @@
+
+
+# 建築
+
+## システムコンテキスト
+- - - このページは、`INDEX.md`の`Start Here`セクションで表示されます。
+- ClawSecは、上流のインテリジェンスソース(NVD +コミュニティの問題)、GitHubの自動化、およびランタイムエージェントの環境間で動作します。
+- - - リポジトリは、静的なサイトコンテンツと、使用前にランタイムスキルが検証する署名済みのアーティファクトの両方を公開します。
+- 外部俳優グループ:
+- GitHub Actions は、CI の実行、リリース、フィードワークフローを実行します。
+- OpenClaw/NanoClawエージェントは、スキル、アドバイザリー、検証スクリプトを消費します。
+- 諮問的問題の承認とリリース/タグの変更をマージするリポジトリメンテナー。
+
+## コンポーネント
+| 製品情報 | 所在地 | 責任 |
+| お問い合わせ |
+| Web UI | `App.tsx`、`pages/`、`components/` | レンダリングスキル・カタログ・アドバイザリー体験 お問い合わせ
+| アドバイザリーフィードコア | `advisories/feed.json*`, `skills/clawsec-suite/.../feed.mjs` | 店舗情報・店舗情報・店舗情報・店舗情報・店舗情報 お問い合わせ
+| スキルパッケージ | `skills/*/` | SBOMメタデータによるインストール可能なセキュリティ機能の配布 お問い合わせ
+| ローカルオートメーションスクリプト | `scripts/*.sh` | ローカルミラー、プレプッシュチェック、マニュアルリリースヘルパーの構築 お問い合わせ
+| CI/CD ワークフロー | `.github/workflows/*.yml` | ライニング・試験・NVD ポーリング・リリース・パッケージ・ページ展開 お問い合わせ
+| Pythonユーティリティレイヤー | `utils/*.py` | スキルメタデータ検証とチェックサム生成 お問い合わせ
+
+ツイート キーフロー
+- スキルカタログの流れ:
+1. スキルアセットを公開するワークフローのリリース/タグ
+2。 ワークフローを展開すると、リリースアセットが発見され、`public/skills/index.json`が構築されます。
+3. `/skills`のページの`public/skills/index.json`とスキルドキュメントのUIフェッチ。
+- アドバイザリーフィードフロー:
+1. `poll-nvd-cves.yml`および`community-advisory.yml`の更新`advisories/feed.json`。
+2. 飼料は署名され、公道に映ります。
+3. Runtime hooks/scripts はローカル署名されたコピーにリモートフィードとフォールバックをロードします。
+- ガードされた取付けの流れ:
+1。 インストーラ要求の対象スキル+バージョン。
+2. アドバイザリー・マッチダーは影響を受けた分光器および重度/リスクヒントを点検します。
+3. 終了コード42は、アドバイザリーが一致したときに2番目の確認を実施します。
+
+##ダイアグラム
+```mermaid
+flowchart TD
+ A["NVD + Community Inputs"] --> B["Feed Workflows\n(poll/community)"]
+ B --> C["advisories/feed.json + signatures"]
+ C --> D["Deploy Workflow Mirrors to public/"]
+ D --> E["React UI (catalog/feed pages)"]
+ C --> F["clawsec-suite hook + installers"]
+ F --> G["Agent advisory alerts / gated install"]
+```
+
+
+
+## インターフェイスと契約
+| インターフェース | 受託フォーム | 検証 |
+| お問い合わせ |
+| スキルメタデータ | `skills/*/skill.json` | Python ユーティリティ + CI 版画チェックで検証 お問い合わせ
+| アドバイザリーフィード | JSON + Ed25519 を取り外すシグネチャ | `feed.mjs` と NanoClaw のシグネチャユーティリティで検証 お問い合わせ
+| チェックサムスマニフェスト | `checksums.json`(+オプションの`.sig`) | ペイロードを信頼する前に追跡・ハッシュマッチング お問い合わせ
+お問い合わせ ホックイベントインターフェース | `HookEvent`(`type`、`action`、`messages`) | ランタイムハンドラは、選択したイベント名だけを処理します。 お問い合わせ
+| ワークフローリリース命名 | タグパターン `-vX.Y.Z` | リリース・デメリットのワークフローで解析し、スキルを身につける お問い合わせ
+
+ツイート 主変数
+| パラメーター | デフォルト | 効果 |
+| お問い合わせ |
+| `CLAWSEC_FEED_URL` | `https://clawsec.prompt.security/advisories/feed.json` | スイートスクリプト・ホックの遠隔アドバイザリーソース お問い合わせ
+| `CLAWSEC_ALLOW_UNSIGNED_FEED` | `0` | 一時無辞フォールバック対応可能 お問い合わせ
+| `CLAWSEC_VERIFY_CHECKSUM_MANIFEST` | `1` | 利用可能なチェックサムマニフェスト検証が必要です。 お問い合わせ
+| `CLAWSEC_HOOK_INTERVAL_SECONDS` | `300` | アドバイザリー・ホックのためのスキャン回転窓 お問い合わせ
+| `CLAWSEC_SKILLS_INDEX_TIMEOUT_MS` | `5000` | リモート・スキル・インデックスは、カタログの発見のためのタイムアウトを取得します。 お問い合わせ
+| `PROMPTSEC_GIT_PULL` | `0` | ウォッチドッグオーディション前のオプションオートプル お問い合わせ
+
+## エラー処理と信頼性
+- フィードのフェッチングは、無効なシグネチャとmalformedマニフェストのために不閉鎖されます。
+- 遠隔フェッチの失敗はローカル署名された供給に優雅に落ちます。
+- ホックの状態は支えられる厳密なモードと原子ファイル書き込みを使用します。
+- UIページでは、HTMLフォールバックがJSONとして機能し、破損したデータをレンダリングすることを避けます。
+- ワークフロー手順は、キーフィンガープリントの一貫性を強化し、スプリットキードリフトを回避します。
+
+## サンプルスニペット
+```tsx
+// Route topology in the web app
+
+
+```
+
+```ts
+// Guarded feed loading contract in advisory hook
+const remoteFeed = await loadRemoteFeed(feedUrl, {
+ signatureUrl: feedSignatureUrl,
+ checksumsUrl: feedChecksumsUrl,
+ checksumsSignatureUrl: feedChecksumsSignatureUrl,
+ publicKeyPem,
+ checksumsPublicKeyPem: publicKeyPem,
+ allowUnsigned,
+ verifyChecksumManifest,
+});
+```
+
+## 実行時間と展開
+| 稼働時間表 | 実行モデル | 出力 |
+| お問い合わせ |
+| Viteアプリ(`npm run dev`) | ローカルフロントエンドサーバー | フィード/スキルのインタラクティブウェブアプリ お問い合わせ
+| GitHub CI | マルチOS マトリックス + 専用ジョブ | リント/タイプ/ビルド/セキュリティとテストの信頼性 お問い合わせ
+お問い合わせ スキルリリースワークフロー | タグ主導の公開 + PR ドライランチェック | リリースアセット, 署名済みのチェックサム, オプションの ClawHub 公開. お問い合わせ
+お問い合わせ ページはワークフローをデプロイ | CI/Release の成功によるトリガ | 静的サイト + 顧問/リリースをミラーリングしました。 お問い合わせ
+| Runtime hooks | OpenClaw イベントホック / NanoClaw IPC | 諮問的アラート、判断、完全性チェック お問い合わせ
+
+##スケーリングノート
+- NVD のポーリングで置かれるキーワードが付いている Advisory の容積スケール; dedupe およびポストろ過制御騒音。
+- ワークフロープロセスのリリースリストをデプロイし、インデックス出力で最新のスキルバージョンを維持します。
+- スキルフォルダによるモジュール境界により、フロントエンド構造を変更することなく新しいセキュリティ機能を追加できます。
+- ペイロードサイズ(フィード/マニフェスト)が小さいため、シグネチャー検証パスは軽量です。
+
+## ソース参照
+- App.tsxアプリ
+- ページ/SkillsCatalog.tsx
+- ページ/フィードSetup.tsx
+- ページ/AdvisoryDetail.tsx
+- ページ/WikiBrowser.tsx
+- スキル/クローセスイート/ホック/クローセ-アドバイザー/ハンドラー.ts
+- スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スキル/clawsec-suite/scripts/discover_skill_catalog.mjs
+- スキル/クローセ・ナンクロー/lib/advisories.ts
+- スキル/クローセ-ナンクロー/lib/signatures.ts
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml
+- .github/workflows/skill-release.yml
diff --git a/wiki/ja/configuration.md b/wiki/ja/configuration.md
new file mode 100644
index 0000000..f36019d
--- /dev/null
+++ b/wiki/ja/configuration.md
@@ -0,0 +1,93 @@
+
+
+# 設定
+
+## スコープ
+- 設定は、フロントエンドのビルド設定、ランタイムフィードパス、ワークフロートリガー、およびスキルメタデータ契約を組み合わせます。
+- ほとんどのランタイムに敏感な制御は`CLAWSEC_`か`OPENCLAW_`とプレフィックスした環境変数です。
+- パス正規化は、セキュリティに敏感であり、意図的に未解決の家庭トークンリテラルを拒否します。
+
+## コアランタイム変数
+| 変数 | デフォルト | によって使用される |
+| お問い合わせ |
+| `CLAWSEC_FEED_URL` | ホストアドバイザリーURL | スイートホークとガードドインストーラーの読み込み お問い合わせ
+| `CLAWSEC_FEED_SIG_URL` | `.sig` | 組織図鑑 | 組織図鑑 お問い合わせ
+| `CLAWSEC_FEED_CHECKSUMS_URL` | フィードURL付近の`checksums.json` | 任意チェックサムマニフェストソース お問い合わせ
+| `CLAWSEC_FEED_PUBLIC_KEY` | スイートローカルPEMファイル | 特筆記検証 お問い合わせ
+| `CLAWSEC_ALLOW_UNSIGNED_FEED` | `0` | 一時移行バイパスの旗 お問い合わせ
+| `CLAWSEC_VERIFY_CHECKSUM_MANIFEST` | `1` | チェックサム・マニフェスト検証を有効にします。 お問い合わせ
+| `CLAWSEC_HOOK_INTERVAL_SECONDS` | `300` | アドバイザリーホックスキャンスロットル お問い合わせ
+
+## パスの決議規則
+| ルール | 行動 | 施行拠点 |
+| お問い合わせ |
+| `~` 拡張 | 自宅のディレクトリに解決 | スイート/ウォッチドッグスクリプトで共有されたパスユーティリティ機能 お問い合わせ
+| `$HOME` / `${HOME}` 拡張 | エスケープ時に解決 | 同じユーティリティ. お問い合わせ
+お問い合わせ Windowsホームトークン | `%USERPROFILE%`, `$env:USERPROFILE` 正規化 | 同じユーティリティ. お問い合わせ
+| エスケープされたトークン(`\$HOME`) | 明示的なエラーで拒否 | 誤ってリテラルディレクトリの作成を防止します。 お問い合わせ
+| 無効な明示的なパス | 警告でデフォルトパスにフォールバックできる | `resolveConfiguredPath`ヘルパー お問い合わせ
+
+## フロントエンドとビルド構成
+- `vite.config.ts`はポート(`3000`)、ホスト(`0.0.0.0`)、パスエイリアス(`@`)を定義します。
+- `index.html`の提供 Tailwind ランタイムの設定、カスタムフォント、ベースカラートークン。
+- `tsconfig.json`は、バンドルモジュールの解像度、`noEmit`、およびJSXランタイムの設定を使用します。
+- `eslint.config.js`はTS、React、hooks、およびスクリプト固有のlintルールを適用します。
+
+## スキルメタデータ 仕様
+| フィールドグループ | 所在地 | 機能 |
+| お問い合わせ |
+お問い合わせ コアスキルアイデンティティ | `skills/*/skill.json` | 名称・バージョン・著者・ライセンス・記述メタデータ お問い合わせ
+| SBOMファイル一覧 | `skill.json -> sbom.files` | 決定版リリース必須項目です。 お問い合わせ
+| プラットフォームメタデータ | `openclaw` または `nanoclaw` ブロック | CLI 要件、トリガー、プラットフォームヒント お問い合わせ
+| スイートカタログメタデータ | `skills/clawsec-suite/skill.json -> catalog` | スイートメンバーの統合/デフォルト/一貫性のある動作 お問い合わせ
+
+## ワークフロー構成
+- スケジュール設定は、`cron`エントリー(`poll-nvd-cves`、`codeql`、`scorecard`)のワークフローに含まれています。
+- リリースワークフローでは、タグのネーミングパターン`-v`が期待しています。
+- 展開ワークフローは、CI/release `workflow_run`イベントとマニュアルディスパッチで起動します。
+- 複合署名アクションは、秘密鍵入力を必要とし、署名直後に署名を検証します。
+
+## サンプルスニペット
+```bash
+# run guarded install with explicit local signed feed paths
+CLAWSEC_LOCAL_FEED="$HOME/.openclaw/skills/clawsec-suite/advisories/feed.json" \
+CLAWSEC_LOCAL_FEED_SIG="$HOME/.openclaw/skills/clawsec-suite/advisories/feed.json.sig" \
+CLAWSEC_FEED_PUBLIC_KEY="$HOME/.openclaw/skills/clawsec-suite/advisories/feed-signing-public.pem" \
+node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill clawtributor --dry-run
+```
+
+```json
+{
+ "name": "example-skill",
+ "version": "1.2.3",
+ "sbom": {
+ "files": [
+ { "path": "SKILL.md", "required": true, "description": "Install docs" }
+ ]
+ }
+}
+```
+
+## 操作上の注意
+- リポジトリの外にキーを署名し、GitHubの秘密を経由して注入してください。
+- ローカル環境変数上書きの絶対パスまたは省略されたホーム式を優先します。
+- 一時的なマイグレーション サポートとして署名されていないフィード モードを、正常な操作は扱いません。
+- 壊れたアーティファクトの参照を避けるために`SKILL.md` URLを編集するとき再実行の解放リンクの検証。
+
+## ソース参照
+- vite.config.ts
+- インデックス.html
+- tsconfig.json
+- eslint.config.js ディレクティブ
+- スキル/ clawsec-suite/skill.json
+- スキル/clawsec-nanoclaw/skill.json
+- スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/utils.mjs
+- スキル/openclaw-audit-watchdog/scripts/load_suppression_config.mjs
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スクリプト/validate-release-links.sh
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/skill-release.yml
+- .github/actions/sign-and-verify/action.yml
diff --git a/wiki/ja/data-flow.md b/wiki/ja/data-flow.md
new file mode 100644
index 0000000..3260344
--- /dev/null
+++ b/wiki/ja/data-flow.md
@@ -0,0 +1,103 @@
+
+
+ツイート データフロー
+
+## プライマリフロー
+- `Advisory ingestion`:NVD/communityの入力は顧客のために、署名された正常化された諮問的な供給に変えられます。
+- `Skill catalog publication`: リリースアセットが発見され、`public/skills/index.json`とパースキルのドキュメント/チェックサムに変換されます。
+- `Runtime enforcement`: スイートとナノクローの消費者は、アドバイザリーデータをロードし、スキルと一致し、アラートや確認ゲートを発します。
+- - - このページは、`INDEX.md`の`Guides`セクションで表示されます。
+
+## ステップバイステップ
+1。 フィードプロデューサーワークフロー/スクリプトフェッチソースデータ (`NVD API` または発行ペイロード).
+2。 JSON は、ロジックが重度/種類/影響領域を正規化し、アドバイザリー ID による重複排除を行います。
+3。 シグネチャー/チェックサムのステップは、分離されたシグネチャとチェックサムマニフェストを生成します。
+4。 `public/`と`public/releases/latest/download/`でワークフローミラー署名済みのアーティファクトを展開します。
+5。 UI 消費者は JSON 形状/コンテンツを検証します。ランタイムの消費者は、フィードデータを信頼する前に、署名/チェックサムを検証します。
+6。 Matchers は、`affected` の仕様をスキル名/バージョンに比較し、アラートを発したり、確認を強制したりします。
+
+## 入力と出力
+入力/出力は下の表でまとめられます。
+
+| 種類 | お名前 | 所在地 | 概要 |
+| お問い合わせ |
+| 入力 | CVE ペイロード | `services.nvd.nist.gov/rest/json/cves/2.0` | ClawSec キーワードでフィルタリングされた脆弱性 お問い合わせ
+| 入力 | コミュニティアドバイザリー問題 | `.github/workflows/community-advisory.yml`イベントペイロード | メンテラー承認問題がアドバイザリーレコードに変身 お問い合わせ
+| 入力 | スキルリリースアセット | GitHub リリース API + アセット | ウェブカタログ作成・ミラーダウンロード お問い合わせ
+| 入力 | ローカルコンフィグ/env | `OPENCLAW_AUDIT_CONFIG`、`CLAWSEC_*` vars | フィードの経路制御・抑制・検証の動作 お問い合わせ
+| 出力 | アドバイザリーフィード | `advisories/feed.json` | キヤノンレポジトリフィード お問い合わせ
+| アウトプット | アドバイザリーシグネチャ | `advisories/feed.json.sig` | フィード認証のデタケドシグネチャ お問い合わせ
+| アウトプット | スキルカタログ | `public/skills/index.json` | `/skills`ページで使用されるランタイムウェブカタログ お問い合わせ
+| アウトプット | リリースチェックサム・サイン | `release-assets/checksums.json(.sig)` | リリースコンシューマー向け整合性マニフェスト お問い合わせ
+| 出力 | ホックの状態 | `~/.openclaw/clawsec-suite-feed-state.json` | スキャンのタイミングを追跡し、一致を通知して下さい。 お問い合わせ
+
+ツイート データ構造
+| 構成 | 主要分野 | 目的 |
+| お問い合わせ |
+| アドバイザリーフィードレコード | `id`、`severity`、`type`、`affected[]`、`published` | UIやインストーラーが使用するリスクデータの単位 お問い合わせ
+| スキルメタデータレコード | `id`、`name`、`version`、`emoji`、`tag` | ウェブ閲覧・インストールの行 お問い合わせ
+| チェックサムスマニフェスト | `schema_version`, `algorithm`, `files` | 予想される消化器の名前をマップします。 お問い合わせ
+| 諮問状態 | `known_advisories`、`last_hook_scan`、`notified_matches` | 繰り返しのアラートやスロットルのスキャンを防ぎます。 お問い合わせ
+| Suppression config | `enabledFor[]`, `suppressions[]` | `checkId` + `skill` によるスキップリストの対象となります。 お問い合わせ
+
+##ダイアグラム
+```mermaid
+flowchart LR
+ A["NVD + Issue Inputs"] --> B["Transform + Deduplicate"]
+ B --> C["advisories/feed.json"]
+ C --> D["Sign + checksums"]
+ D --> E["public/advisories + releases/latest"]
+ E --> F["Web UI fetch"]
+ E --> G["Suite/NanoClaw verification"]
+ G --> H["Match skills + emit alerts/gates"]
+```
+
+## 状態とストレージ
+| 店舗 | パス・スコープ | パス |
+| お問い合わせ |
+| キヤノンのアドバイザリー | `advisories/` | NVD + コミュニティワークフローとローカルのポピュレーションスクリプト お問い合わせ
+お問い合わせ 組込みアドバイザリーコピー | `skills/clawsec-feed/advisories/` と `skills/clawsec-suite/advisories/` | 同期/包装プロセスとリリースワークフロー お問い合わせ
+| パブリックミラー | `public/advisories/`、`public/releases/` | ワークフローの展開 お問い合わせ
+| 稼働時間状態 | `~/.openclaw/clawsec-suite-feed-state.json` | 諮問ホックの状態の永続性。 お問い合わせ
+| NanoClawキャッシュ | `/workspace/project/data/clawsec-advisory-cache.json` | ホスト・サイド・アドバイザリー・キャッシュ・マネージャー お問い合わせ
+| 整合状態 | `/workspace/project/data/soul-guardian/`(ナノクロー) | 整合性モニターベースライン・オーディオストレージ お問い合わせ
+
+## サンプルスニペット
+```bash
+# Local feed flow (NVD fetch -> transform -> sync)
+./scripts/populate-local-feed.sh --days 120
+jq '.updated, (.advisories | length)' advisories/feed.json
+```
+
+```bash
+# Runtime guarded install uses signed feed paths
+CLAWSEC_LOCAL_FEED=~/.openclaw/skills/clawsec-suite/advisories/feed.json \
+CLAWSEC_FEED_PUBLIC_KEY=~/.openclaw/skills/clawsec-suite/advisories/feed-signing-public.pem \
+node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+```
+
+## 失敗モード
+- NVD率の限界(`403/429`)は送りを遅らせ、retries/backoffを要求できます。
+- 欠損または無効な離脱署名により、異常終了モードのフィード拒否が発生します。
+- JSONエンドポイントのHTMLフォールバック応答は、明示的にフィルタリングされていない限り、偽陽性を生成できます。
+- パストークンの誤設定(`\$HOME`)は、ローカルのフォールバックパスの解像度を破ることができます。
+- ワークフローで公開鍵のフィンガープリントをミスマッチして、ハードなCI障害が発生します。
+
+## ソース参照
+- アドバイザリー/フィード.json
+- アドバイザリー/フィード.json.sig
+- スクリプト/populate-local-feed.sh
+- スクリプト/populate-local-skills.sh
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml
+- .github/workflows/skill-release.yml
+- スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs
+- スキル/クローセスイート/ホック/クローセ-アドバイザー/lib/state.ts
+- スキル/クローセスイート/ホック/クローセ管理人/lib/matching.ts
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スキル/クローセ・ナンクロー/lib/advisories.ts
+- スキル/法律/犯罪サービス/アドバイザー/キャッシュ.ts
diff --git a/wiki/ja/dependencies.md b/wiki/ja/dependencies.md
new file mode 100644
index 0000000..031f4ef
--- /dev/null
+++ b/wiki/ja/dependencies.md
@@ -0,0 +1,106 @@
+
+
+# 依存関係
+
+##ビルドとランタイム
+| レイヤー | プライマリ依存 | プライマリ依存症 | なぜそれが存在なのか |
+| お問い合わせ |
+| フロントエンドのランタイム | `react`、`react-dom`、`react-router-dom`、`lucide-react` | UIのレンダリング、ルーティング、アイコングラフィ。 お問い合わせ
+| マークダウンレンダリング | `react-markdown`、`remark-gfm` | レンダリング・スキル・ドキュメント/readmes、アプリ内ウィキマークダウンページ お問い合わせ
+| ビルドツーリング | `vite`, `@vitejs/plugin-react`, `typescript` | 速いTS/TSX束縛と生産ビルド. お問い合わせ
+| python ユーティリティ | stdlib + `ruff`/`bandit` ポリシー から `pyproject.toml` | 検証・パッケージのスキルと静的なチェックを実行します。 お問い合わせ
+お問い合わせ シェルオートメーション | `bash`、`jq`、`curl`、`openssl`、`sha256sum`/`shasum` | フィードポーリング、サイン、チェックサム生成、リリースチェック。 お問い合わせ
+
+## 依存性の詳細
+| パッケージ | バージョン制約 | スコープ |
+| お問い合わせ |
+| `react` / `react-dom` | `^19.2.4` | フロントエンドランタイム |
+| `react-router-dom` | `^7.13.1` | フロントエンドルーティング |
+| `lucide-react` | `^0.575.0` | UIアイコンセット |
+| `vite` | `^7.3.1` | 開発サーバー | ビルド |
+| `typescript` | `~5.8.2` | タイプチェック |
+| `eslint` | `^9.39.2` | JS/TSライニング |
+| `@typescript-eslint/*` | `^8.55.0` / `^8.56.0` | TSXQTOKEN2QXZ | ツ・リントパーサ・ルール |
+| `fast-check` | `^4.5.3` | 物件・機能テスト |
+
+| オーバーライド | ピン留め版 | ライエーレ |
+| お問い合わせ |
+| `ajv` | `6.14.0` | セキュリティと互換性の安定化 お問い合わせ
+| `balanced-match` | `4.0.3` | トランジティブ脆弱性制御 お問い合わせ
+| `brace-expansion` | `5.0.2` | 移行依存症の硬化 お問い合わせ
+| `minimatch` | `10.2.1` | 決定的な依存行動 お問い合わせ
+
+## 外部サービス
+| サービス | ご利用 | | ご利用条件 | ご利用条件 |
+| お問い合わせ |
+| NVD API(`services.nvd.nist.gov`) | `poll-nvd-cves` ワークフロー + ローカルフィードスクリプト | キーワード/日付ウィンドウでCVEをプルする お問い合わせ
+| GitHub API | ワークフローの展開・リリース | リリースの発見、アセットのダウンロード、出力の公開 お問い合わせ
+| GitHub Pages | ワークフローの展開 | 静的なサイトを運営し、アーティファクトを映す お問い合わせ
+| ClawHub CLI/registry | スクリプトのインストール + オプションの公開ジョブ | インストールと公開スキル. お問い合わせ
+| オプションのローカルSMTP/sendmail | `openclaw-audit-watchdog`スクリプト | 監査報告書をメールで配信 お問い合わせ
+
+## 開発ツール
+| ツール | 呼び出し | 取材 | 取材 |
+| お問い合わせ |
+| ESLint | `npx eslint . --ext .ts,.tsx,.js,.jsx,.mjs --max-warnings 0` | フロントエンド・スクリプト・ライニング お問い合わせ
+| TypeScript | `npx tsc --noEmit` | コンパイル時間TS契約チェック お問い合わせ
+| ラフ | `ruff check utils/` | パイソンスタイルとバグパターンチェック お問い合わせ
+| バンディット | `bandit -r utils/ -ll` | python セキュリティー検査 お問い合わせ
+| トライビー | ワークフロー + ローカルラン | FS/config 脆弱性スキャン お問い合わせ
+| Gitleaks | `scripts/prepare-to-push.sh` オプションのローカルラン | プッシュ前のシークレットリーク検出 お問い合わせ
+
+## サンプルスニペット
+```json
+{
+ "scripts": {
+ "dev": "vite",
+ "build": "vite build",
+ "preview": "vite preview"
+ },
+ "dependencies": {
+ "react": "^19.2.4",
+ "react-router-dom": "^7.13.1"
+ }
+}
+```
+
+```toml
+[tool.ruff]
+target-version = "py310"
+line-length = 120
+
+[tool.bandit]
+exclude_dirs = ["__pycache__", ".venv"]
+skips = ["B101"]
+```
+
+## 互換性のノート
+- `date`と`stat`の使用におけるmacOSとLinuxの違いに対するローカルスクリプトアカウント。
+- 一部のワークフロー/スクリプトでは、Ed25519と`pkeyutl -rawin`で使用されるOpenSSL機能が必要です。
+- Windows サポートはNodeベースの工具細工のために最も強いです;POSIXの貝パスはWSL/Git Bashを必要とするかもしれません。
+- 供給の消費者は移住段階のための両立性バイパスを含んでいます、署名されたモードは意図された安定した状態です。
+
+## 検証ノート
+- スキルリリースタグは、`-v` をフォローし、CI/deploy 自動化によって解析されます。
+- PR検証は、`skill.json`と`SKILL.md`のフロントマッター間でのバージョンパティを強化します。
+- - - パブリックスキル指数は、UI表示のためのスキルごとに最新の発見されたバージョンを保持します。
+- 署名されたアーティファクトマニフェスト(`checksums.json`)は、リリースごとにバージョンアップされ、ファイルハッシュとURLが含まれています。
+
+## ソース参照
+- パッケージ.json
+- パッケージ-lock.json
+- pyproject.toml
+- eslint.config.js ディレクティブ
+- tsconfig.json
+- スクリプト/prepare-to-push.sh
+- スクリプト/populate-local-feed.sh
+- スクリプト/populate-local-skills.sh
+- .github/workflows/ci.yml
+- .github/workflows/codeql.yml
+- .github/workflows/scorecard.yml
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/deploy-pages.yml
+- .github/workflows/skill-release.yml
diff --git a/wiki/ja/exploitability-scoring.md b/wiki/ja/exploitability-scoring.md
new file mode 100644
index 0000000..42ce991
--- /dev/null
+++ b/wiki/ja/exploitability-scoring.md
@@ -0,0 +1,425 @@
+
+
+# Exploitability Scoring 方法論
+
+## 概要
+
+ClawSecの悪用性スコアリングシステムは、AIエージェントの展開(OpenClaw/NanoClaw)用に特別に設計されたコンテキスト・ウェアの脆弱性評価を提供します。 すべての環境を均等に扱う一般的なCVSSスコアとは異なり、当社のスコアリングは、アラート疲労を軽減し、実用的な脅威を優先するAIエージェントのユニークな攻撃面と使用パターンを考慮する。
+
+## スコアリングレベル
+
+| レベル | 重症 | 意味 |
+お問い合わせ
+| `high` | クリティカル・ハイ | 代表的な代理店の展開で期待できる |
+| `medium` | ミディアム | 構成、保証調査 |
+| `low` | 低 | エージェントのコンテキスト、低優先順位 |
+| `unknown` | 不明 | 悪用性を評価するための十分なデータ |
+
+## スコアリング工場
+
+################################################################################################################################################################################################################################################################ 1. CVSSベーススコア(ベースライン)
+
+分析は、CVSSベーススコアを基礎として開始します。
+
+-**CVSS ≥ 9.0**:クリティカルな重度 → 初期スコア `high`
+- **CVSS 7.0-8.9**: 高重度 → 初期スコア `high`
+- **CVSS 4.0-6.9**: 中程度の重度 → 初期スコア `medium`
+- **CVSS 1.0-3.9**:低重度 → 初期スコア `low`
+- **CVSS**なし: → 初期スコア `unknown`の特長
+
+################################################################################################################################################################################################################################################################ 2. 攻撃ベクトル解析(CVSSメトリクス)
+
+アナライザは、CVSS v2、v3.0、v3.1 ベクトルを解析して評価します。
+
+####ネットワークのアクセシビリティ
+-**AV:N**(ネットワーク):ネットワーク上でリモートで利用
+-**AV:A**(隣接):ローカルネットワークアクセスを要求します
+- ** AV:L** (ローカル):ローカル システム アクセスを要求して下さい
+- **AV:P** (物理的):物理的なアクセスを要求して下さい
+
+**エージェントへの影響**: エージェントはネットワークサービスとして実行したり、外部API呼び出しを行うため、ネットワークアクセス可能な脆弱性が高まります。
+
+####認証要件
+-**PR:N / Au:NONE**:認証不要 → スコアアップ
+-**PR:L / Au:SINGLE**:必要な低い特権
+-**PR:H / Au:MULTIPLE**:高い特権が必要 → スコアを削減
+
+**エージェントへの影響**: 未認証の悪用は、一般に公開されたエージェント API には不可欠です。
+
+#### ユーザーインタラクション
+-**UI:N**:ユーザーインタラクションは必要ありません → スコアを上昇させる
+-**UI:R**:ユーザーインタラクションを要求し、スコアを削減
+
+**エージェントへの影響**: エージェントは自律的に動作することが多いため、ユーザインタラクションが必要な脆弱性はあまり重要ではありません。
+
+###### 攻撃の複雑さ
+- **AC:L**:低い複雑さ→の上昇のスコア
+-**AC:M / AC:H**:中/高複雑→中立またはスコアを減らす
+
+**エージェントへの影響**: 低複雑性悪用は、大量攻撃で自動化され、使用される可能性が高い。
+
+################################################################################################################################################################################################################################################################ 3. 脆弱性タイプ(採用コンテキスト)
+
+ClawSecは、脆弱性タイプがAIエージェントのデプロイメントにどのように影響するかに基づいてスコアを調整します。
+
+#### エージェントコンテキスト内の高リスクタイプ
+
+**リモートコード実行(RCE)* * 必須
+```
+Score: Always HIGH
+Rationale: RCE is critical in agent deployments
+```
+AIエージェントは、その機能の一部として任意のコードを実行します。 RCEの脆弱性により、攻撃者がハイジャックエージェントの実行フローを解除したり、資格情報を公開したり、他のシステムにピボットしたりすることができます。
+
+**サーバー・サイド・リクエスト・フォージェリ(SSRF)* * 必須
+```
+Score: Elevated to HIGH if CVSS ≥ 6.0
+Rationale: SSRF affects agents making external requests
+```
+エージェントは、外部 API を頻繁に呼び出し、内部サービスにアクセスし、リモートリソースを取得します。 SSRF は、攻撃者を次のようになります。
+- 内部クラウドメタデータサービス(AWS IMDSv1、GCPメタデータ)にアクセス
+- 社内ネットワークへのピボット
+- DNSトンネリングによるデータの抽出
+
+**Path Traversal / ディレクトリ Traversal* * 必須
+```
+Score: Elevated to HIGH if CVSS ≥ 6.0
+Rationale: Path traversal affects agents with file access
+```
+エージェントはファイルを読み、スクリプトを実行し、コードベースを管理します。 パス・トラバーサールは以下を可能にします。
+- 機密設定ファイル(.env、認証情報)の読み込み
+- SSHキー、APIトークンへのアクセス
+- 重要なシステムファイルを上書き
+
+**Commandの注入**
+```
+Score: Always HIGH
+Rationale: Command injection is critical in agent deployments
+```
+RCEと同様に、エージェントはシステムとやり取りするためにシェルコマンドを実行します。 コマンドインジェクションにより、フルシステムの妥協を許します。
+
+#### 中リスクタイプ
+
+**プロトタイプ汚染(Node.js)* * 必須
+```
+Score: Elevated from LOW to MEDIUM
+Rationale: Prototype pollution can escalate in Node.js agents
+```
+Node.js 上で実行される多くのエージェントフレームワーク。プロトタイプの汚染は、以下につながる可能性があります。
+- 認証チェックのバイパス
+- 特権エスカレーション
+- サービスの拒否
+
+**SQLの注入/NoSQLの注入**
+```
+Score: Elevated to HIGH if network-accessible and unauthenticated
+Rationale: Injection affects agents with database access
+```
+会話履歴、ユーザーデータ、またはデータベース内のツール結果を保存するエージェントは、インジェクション攻撃に脆弱です。
+
+####下リスクタイプ
+
+**クロスサイトスクリプト(XSS)* * 必須
+```
+Score: Reduced to MEDIUM if not network-accessible
+Rationale: XSS has limited impact in headless agents
+```
+エージェントは、通常、ブラウザでHTMLをレンダリングせず、XSSの影響を軽減します。 しかし、エージェント管理 UI やチャットインターフェースの XSS は懸念が残っています。
+
+################################################################################################################################################################################################################################################################ 4. 空室状況
+
+`--check-exploits`が有効になっている場合、アナライザはパブリックエクスプロイトのリファレンスURLをチェックします。
+
+**明示的な表示器:**
+- 悪用-db.com/悪用-database.com
+- パケットtormsecurity.com
+- github.com/exploit、github.com/poc
+- metasploitフレームワークモジュール
+- 「/exploit」、「/poc」、「/proof-of-concept」を含むURL
+
+**スコアの高度:**
+- `low` → `medium` (利用できるexploit)
+- `medium` → `high` (利用できるexploit)
+- `unknown` → `medium` (exploit available + CVSS > 0 )
+
+**Rationale**: 公共は攻撃者のためのスキル障壁を下げ、自動搾取の可能性を高めます。
+
+## スコアリングアルゴリズム
+
+アナライザはこの決定ツリーに従います。
+
+```
+1. Parse CVSS score → set baseline (high/medium/low/unknown)
+2. Parse CVSS vector → analyze attack characteristics
+3. Adjust for attack vector:
+ - Network-accessible + no auth + no UI → elevate to HIGH
+ - Local-only access → reduce HIGH to MEDIUM
+4. Adjust for vulnerability type:
+ - Check against agent-specific risk categories
+ - Elevate or reduce score based on deployment context
+5. Check for public exploits (if enabled):
+ - Elevate score if exploits detected
+6. Generate rationale explaining the final score
+```
+
+## 例
+
+##例1:クリティカルなRCE(高感度)
+
+```json
+{
+ "cve_id": "CVE-2024-12345",
+ "cvss_score": 9.8,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H",
+ "type": "remote_code_execution",
+ "description": "Unauthenticated RCE in Express.js framework"
+}
+```
+
+**分析の出力:**
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "Critical CVSS score (9.8); remotely exploitable without authentication; RCE is critical in agent deployments"
+}
+```
+
+**なぜハイ**:クリティカルCVSS +ネットワークアクセス可能+オースなし+ RCEタイプ。
+
+##例2:エージェントAPIのSSRF(高感度)
+
+```json
+{
+ "cve_id": "CVE-2024-23456",
+ "cvss_score": 7.3,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:L/I:L/A:L",
+ "type": "server_side_request_forgery",
+ "description": "SSRF in webhook handler allows internal network access"
+}
+```
+
+**分析の出力:**
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "High CVSS score (7.3); remotely exploitable without authentication; SSRF affects agents making external requests"
+}
+```
+
+**ハイ**: SSRF は、API 呼び出しを行うエージェントに不可欠です。 認証なしでアクセス可能でリスクが高まります。
+
+##例3:公共の爆発を伴うパストラバース(高感度)
+
+```json
+{
+ "cve_id": "CVE-2024-34567",
+ "cvss_score": 6.5,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N",
+ "type": "path_traversal",
+ "references": [
+ "https://exploit-db.com/exploits/51234",
+ "https://nvd.nist.gov/vuln/detail/CVE-2024-34567"
+ ]
+}
+```
+
+**分析出力(--check-exploitsと):**
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "Medium CVSS score (6.5); network accessible; path traversal affects agents with file access; public exploit available (1 source)"
+}
+```
+
+**ハイ**:パストラバース+エージェントファイルアクセス+公共利用は、中型CVSSを高悪用性に高めます。
+
+## 例4:エージェントUIのXSS
+
+```json
+{
+ "cve_id": "CVE-2024-45678",
+ "cvss_score": 7.1,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:L",
+ "type": "cross_site_scripting",
+ "description": "Stored XSS in agent management dashboard"
+}
+```
+
+**分析の出力:**
+```json
+{
+ "exploitability_score": "medium",
+ "exploitability_rationale": "High CVSS score (7.1); network accessible; XSS has limited impact in headless agents"
+}
+```
+
+**Why MEDIUM**:高いCVSSにもかかわらず、XSSはエージェントのデプロイメント(ヘッドレス操作)ではあまり重要ではありません。 ユーザーインタラクションが必要です。
+
+## 例5: ローカル特権のエスカレーション(媒体の説明)
+
+```json
+{
+ "cve_id": "CVE-2024-56789",
+ "cvss_score": 8.8,
+ "cvss_vector": "CVSS:3.1/AV:L/AC:L/PR:L/UI:N/S:C/C:H/I:H/A:H",
+ "type": "privilege_escalation",
+ "description": "Local privilege escalation via symbolic link attack"
+}
+```
+
+**分析の出力:**
+```json
+{
+ "exploitability_score": "medium",
+ "exploitability_rationale": "High CVSS score (8.8); requires local access"
+}
+```
+
+**医療**:高いCVSSにもかかわらず、ローカルアクセスが必要です。 エージェントは、通常、ローカルエスカレーションが限られた影響を持っているコンテナ化された/サンドボックス化された環境で実行されます。
+
+##例6:Exploitによる試作汚染(高感度)
+
+```json
+{
+ "cve_id": "CVE-2024-67890",
+ "cvss_score": 5.3,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:L/A:N",
+ "type": "prototype_pollution",
+ "description": "Prototype pollution in lodash merge function",
+ "references": [
+ "https://github.com/exploit/prototype-pollution-poc",
+ "https://snyk.io/vuln/SNYK-JS-LODASH-1234567"
+ ]
+}
+```
+
+**分析出力(--check-exploitsと):**
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "Medium CVSS score (5.3); remotely exploitable without authentication; prototype pollution can escalate in Node.js agents; public exploit available (1 source)"
+}
+```
+
+**なぜハイ**:Node.jsエージェントのプロトタイプ汚染 + 公開悪用 + authなしでアクセス可能 = 適度なCVSSにもかかわらず高いリスク。
+
+#ClawSec ワークフローでの ## 利用
+
+###自動スキャリング(NVDフィード)
+
+`poll-nvd-cves.yml`ワークフローは、新しいCVEを自動的にスコアします。
+
+```bash
+# Workflow step
+python utils/analyze_exploitability.py --json --check-exploits < cve-data.json
+```
+
+`advisories/feed.json`のアドバイザリーには、以下が含まれます。
+```json
+{
+ "id": "CVE-2024-12345",
+ "severity": "high",
+ "exploitability_score": "high",
+ "exploitability_rationale": "Critical CVSS score (9.8); remotely exploitable without authentication; RCE is critical in agent deployments",
+ "attack_vector_analysis": {
+ "is_network_accessible": true,
+ "requires_authentication": false,
+ "requires_user_interaction": false,
+ "complexity": "low"
+ }
+}
+```
+
+## マニュアル分析
+
+セキュリティ研究者は、CVEを手動で分析することができます。
+
+```bash
+# Basic analysis
+echo '{"cve_id":"CVE-2024-12345","cvss_score":7.3,"type":"ssrf"}' | \
+ python utils/analyze_exploitability.py --json
+
+# With exploit detection
+echo '{"cve_id":"CVE-2024-12345","cvss_score":7.3,"references":["https://exploit-db.com/exploits/51234"]}' | \
+ python utils/analyze_exploitability.py --json --check-exploits
+```
+
+## Exploitability によるフィルタリング
+
+ユーザーは、悪用性スコアでアドバイザリーをフィルタリングすることができます。
+
+```bash
+# Get only high-exploitability advisories
+curl -s https://clawsec.prompt.security/feed.json | \
+ jq '.advisories[] | select(.exploitability_score == "high")'
+
+# Prioritize by exploitability and severity
+curl -s https://clawsec.prompt.security/feed.json | \
+ jq '[.advisories[] | select(.exploitability_score == "high" and .severity == "critical")] | sort_by(.cvss_score) | reverse'
+```
+
+## バックフィルディング・アドバイザリー(歴史的メンテナンス)
+
+`scripts/backfill-exploitability.sh`は、リポジトリのメンテナンスのための歴史的なメンテナユーティリティとして保持されます。
+通常のアドバイザリー世代の主流ではありません。
+
+優先パス:
+
+1。 CI の正式なパス: NVD ワークフローを init/reset で実行し、NVD のアドバイザリーを再構築し、パイプラインのアーティファクトに署名します。
+2。 ローカル開発者パス: `./scripts/populate-local-feed.sh --force` を実行して、ローカルフィードを悪用性のコンテキストで再人口化します。
+
+既に存在しているレガシーフィードコンテンツを明示的に修復するときにのみ、バックフィルを使用してください。
+
+## コミュニティ貢献
+
+コミュニティメンバーは、悪用性評価を提出することができます。
+
+1。 **GitHub の問題による報告**: 悪用性文脈で CVE を報告するために、アドバイザリーテンプレートを使用する
+2。 **Automated Analysis**: `community-advisory.yml`ワークフローはコミュニティ報告されたCVEを自動的に得ます
+3。 **Manual Review**: 保守者のレビューと悪用性評価の承認
+4。 **Feed Update**: 承認されたアドバイザリーは、悪用スコアのフィードに追加されます
+
+## 限界と未来の仕事
+
+##現在の制限
+
+1。 **統計分析**: スコアリングは動的ランタイム解析ではなく、CVEメタデータに基づいています
+2.**バージョン検出なし**:特定のバージョンが脆弱であるかどうかはチェックしません
+3。 **バイナリ分類**: 部分的な緩和や防衛の深さを考慮することはありません
+4。 **限られたコンテキスト**:正確なエージェントの構成やデプロイされたツールがわからない
+
+###将来の強化
+
+1。 **EPSSインテグレーション**:EPSS(Exploit Prediction Scoring System)の確率スコアを組み込む
+2。 **KEV Matching**:CISA KEV(Known Exploited Vulnerabilities)カタログのクロスリファレンス
+3。 **エージェントプロファイリング**: デプロイされたエージェントの機能と公開された API を検討する
+4。 **運転検出**:WAF規則、サンドボックス、その他の補償制御の確認
+5。 **MLベースの規模**: 歴史データに基づく悪用性を予測するために機械学習を使用する
+
+## リファレンス
+
+-**CVSS v3.1仕様**:[https://www.first.org/cvss/v3.1/specification-document](https://www.first.org/cvss/v3.1/specification-document)
+- **CVSS v2 ガイド**:[https://www.first.org/cvss/v2/guide](https://www.first.org/cvss/v2/guide)
+- **EPSS**: [https://www.first.org/epss/](https://www.first.org/epss/)
+- **CISA KEV**:[https://www.cisa.gov/known-exploited-vulnerabilities-catalog](https://www.cisa.gov/known-exploited-vulnerabilities-catalog)
+- **NVD API**:[https://nvd.nist.gov/developers/vulnerabilities](https://nvd.nist.gov/developers/vulnerabilities)
+
+ツイート 貢献する
+
+悪用性のスコアリング方法論を改善するため:
+
+1。 **テストケースを省略**:`utils/analyze_exploitability.py`にテストケースを追加
+2。 **False Positives/Negatives** の報告: CVE の例でGitHub の問題を開いた
+3。 **スコープアジャスメントの提案**: 合理的かつ例でPRを提出する
+4。 **シェアエージェントコンテキスト**:エージェント固有の脆弱性パターンの投稿
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for detailed contribution guidelines.
+
+お問い合わせ
+
+**によって維持される**: [Prompt Security](https://prompt.security)
+**ライセンス**:AGPL-3.0-or-later
+**最終更新**:2026-03-01
diff --git a/wiki/ja/glossary.md b/wiki/ja/glossary.md
new file mode 100644
index 0000000..da1b0a3
--- /dev/null
+++ b/wiki/ja/glossary.md
@@ -0,0 +1,62 @@
+
+
+ツイート 用語集
+
+## 利用規約
+| 用語 | 定義 |
+| お問い合わせ |
+| アドバイザリーフィード | スキル/プラットフォームのセキュリティアドバイザリーを含むJSON文書(`feed.json`) お問い合わせ
+| `skill@1.2.3`、ワイルドカード、マッチングロジックで使用される範囲などのスキルセレクター お問い合わせ
+| ガードド インストール | アドバイザーが一致したときに明示的な確認を必要とする2段階のインストーラーの動作。 お問い合わせ
+| SBOMファイル | 包装・検証に用いられる`skill.json`における技術実証済みのアーティファクトリスト お問い合わせ
+| 別売のシグネチャー | ベース64 署名ファイル(`.sig`)は、署名されたペイロードから別途保存されます。 お問い合わせ
+| チェックサムマニフェスト | ペイロードの完全性を検証するために使用されるファイルハッシュマップ(`checksums.json`) お問い合わせ
+
+## スキル包装条件
+| 用語 | 定義 |
+| お問い合わせ |
+| スキルタグ | リリース自動化で使われる`-v`としてフォーマットされたGitタグ。 お問い合わせ
+| リリースアセット | GitHub リリースに添付されているファイル(zip、`skill.json`、チェックサム、シグネチャ) お問い合わせ
+| カタログのインデックス | `public/skills/index.json`, ウェブカタログで消費される生成リスト お問い合わせ
+| 組込み部品 | 別々に含まれている1つのスキルからの機能束(例えばスイートで埋め込まれる供給のために)。 お問い合わせ
+
+## 諮問とセキュリティ規約
+| 用語 | 定義 |
+| お問い合わせ |
+| フェイルクローズド検証 | 署名またはチェックサム検証が失敗した場合のペイロードを差し込みます。 お問い合わせ
+| 符号なしの互換性モード | `CLAWSEC_ALLOW_UNSIGNED_FEED=1`で有効な一時的なバイパスパスパス お問い合わせ
+| Suppression Rule | 既知の知的/受容性の調査を抑制する`checkId`および`skill`のエントリーマッチングの設定 お問い合わせ
+| キー指紋 | キーの一貫性の点検に使用する DER によって符号化される公共のキーの SHA-256 の消化器。 お問い合わせ
+
+##ランタイムとプラットフォーム利用規約
+| 用語 | 定義 |
+| お問い合わせ |
+| OpenClaw Hook | アドバイザリーをチェックするランタイムイベントハンドラ(`clawsec-advisory-guardian`) お問い合わせ
+| NanoClaw IPC | 諮問のリフレッシュ、シグネチャ検証、整合性チェックのためのホスト/コンテーナータスク交換 お問い合わせ
+| 完全性ベースライン | 保護されたファイルのための承認されたハッシュ/スナップショットを保存しました。 お問い合わせ
+| ハッシュチェーン監査ログ | 各エントリーが事前のハッシュに依存する監査ログのみを表示 お問い合わせ
+
+## CI/CD 利用規約
+| 用語 | 定義 |
+| お問い合わせ |
+| NVD CVEs ワークフロー | NVD CVEs をアドバイザリーに送出・変換するワークフローをスケジュール お問い合わせ
+| コミュニティ・アドバイザリーワークフロー | 認定コミュニティ・アドバイザリーを発行する課題・ラベル・トリガーワークフロー お問い合わせ
+| スキル・リリースワークフロー | スキル・リリース・ワークフロー | タグ・トリガー・パッケージ・署名・出版 パイプライン お問い合わせ
+| ページワークフローの展開 | サイトアセットをビルドするワークフローと、リリース/アドバイザーアーティファクトをミラーリングするワークフロー お問い合わせ
+
+## ソース参照
+- タイプ。ts
+- スキル/ clawsec-suite/skill.json
+- スキル/clawsec-nanoclaw/skill.json
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs
+- スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/suppression.mjs
+- スキル/クローセ・ナンクロー/ガーディアン/積分僧侶。ts
+- スクリプト/populate-local-feed.sh
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/community-advisory.yml
+- .github/workflows/skill-release.yml
+- .github/workflows/deploy-pages.yml
diff --git a/wiki/ja/localization.md b/wiki/ja/localization.md
new file mode 100644
index 0000000..ce48c43
--- /dev/null
+++ b/wiki/ja/localization.md
@@ -0,0 +1,71 @@
+
+
+# ローカリゼーションワークフロー
+
+## 目的
+ClawSec README および wiki ページのリピート可能な docs ローカリゼーション パイプラインを定義します。
+
+## スコープ
+- ソース言語:英語(`README.md`、`wiki/*.md`)
+- 現在の翻訳言語:スペイン語(`README.es.md`、`wiki/es/*.md`)
+- 韓国の試験言語:韓国(`README.ko.md`、`wiki/ko/*.md`)
+- 将来の言語:`wiki//...`と`README..md`
+
+## 真実のルールのソース
+1。 英語のファイルは正式です。
+2. 翻訳は、コマンド、ファイルパス、コードブロック、および識別子を正確に保存する必要があります。
+3。 商品名と技術名は翻訳されていないまま(`ClawSec`、`OpenClaw`、`NanoClaw`、`Hermes`、`Picoclaw`、スキルパッケージ名)。
+4。 翻訳のカバレッジが部分的である場合、翻訳されたファイルは明示的にスコープを記述する必要があります。
+
+## フォルダー コンベンション
+- README 翻訳:
+- `README.es.md`
+- 未来:`README.fr.md`、`README.de.md`、`README.ja.md`、等。
+- ウィキ翻訳:
+- `wiki/es/INDEX.md`
+- `wiki/es/.md`
+- 未来:`wiki/fr/.md`、`wiki/de/.md`、等。
+- ローカリゼーションアセット:
+- `wiki/i18n/terminology-en-es.md`
+- `wiki/i18n/translation-tracker.md`
+
+## ワークフローの更新
+1。 **ソースコードの初期化* * 必須
+- 翻訳前の明確さと構造のための英語ソースのドキュメントを更新します。
+2。 **Record delta **
+- `wiki/i18n/translation-tracker.md`で英語ページを変更しました。
+3. **Translate changed pages**
+- マークダウン構造と見出しレベルを維持します。
+- コマンドブロックを無接触に保ちます。
+4. **QA pass**
+- リンクが解決することを確認します。
+- コードブロックとインラインコマンドの検証は変更されません。
+- `terminology-en-es.md`を使用した用語集の一貫性を確認します。
+5. **Regenerate exports**
+- `npm run gen:wiki-llms`を実行します。
+6. **Review and PR**
+- 翻訳されたページの要約と残りのギャップを含みます。
+
+## 翻訳 QA チェックリスト
+- [ ] 階層を保持する。
+- [ ] コマンドスニペットは変更され、実行できません。
+- [ ] ファイルパスとURLは変更されません。
+- [ ] スキルとプラットフォーム名が変更されていない。
+- [ ]セキュリティ用語の一貫性。
+- [ ] `wiki/INDEX.md`は翻訳リンクエントリを持っています。
+- [ ] `wiki//INDEX.md`は、翻訳されていないときに重要な英語ページに戻ります。
+
+## おすすめ言語ロールアウト
+1。 スペイン語(`es`) - フェーズ1ベースラインで行われます。
+2. フランス(`fr`)、ドイツ(`de`)、幅広い技術聴衆のための。
+3. 高度のプラットホームの文書のための日本語(`ja`)。
+
+## ソース参照
+- README.mdの
+- README.es.mdの
+- wiki/INDEX.md(ウィキ・インデックス)
+- wiki/es/INDEX.md(ウィキ・エス・インデックス)
+- wiki/es/overview.md
diff --git a/wiki/ja/migration-signed-feed.md b/wiki/ja/migration-signed-feed.md
new file mode 100644
index 0000000..63fcc26
--- /dev/null
+++ b/wiki/ja/migration-signed-feed.md
@@ -0,0 +1,185 @@
+
+
+# 移行記録: 署名されていないフィード → 署名されたフィード (完了)
+
+ツイート 1) 目的とステータス
+
+ClawSec のアドバイザリーディストリビューションが署名されていない `feed.json` デリバリーから、レガシークライアントの互換性が保持された状態の確認に移行する方法を文書化します。
+
+`main`の現在の状態:
+- 署名されたフィード・パブリッシングは、アドバイザリー・ワークフローとワークフローのデプロイで有効です。
+- スイートおよびNanoClawの消費者は署名された供給のエンドポイントにデフォルトで置きます。
+- 署名されていない動作は、明示的な互換性バイパス(`CLAWSEC_ALLOW_UNSIGNED_FEED=1`)としてのみ存在します。
+
+ツイート 2)ベースライン(今日、ポストマイグレーション)
+
+アクティブな使用中の現在のフィードパス:
+- 真実の源:`advisories/feed.json`
+- ソース署名: `advisories/feed.json.sig`
+- スキルコピー:`skills/clawsec-feed/advisories/feed.json`
+- スキルコピー署名:`skills/clawsec-feed/advisories/feed.json.sig`
+- ページのコピー: `public/advisories/feed.json`
+- ページ署名: `public/advisories/feed.json.sig`の特長
+- 最も最近のミラーのコピー: `public/releases/latest/download/advisories/feed.json` (+ `.sig`)
+
+現在の消費者のデフォルト:
+- `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`
+- `skills/clawsec-suite/scripts/guarded_skill_install.mjs`
+- `skills/clawsec-nanoclaw/lib/advisories.ts`
+- デフォルトURL:`https://clawsec.prompt.security/advisories/feed.json`
+
+ツイート 3) 移行原則
+
+-**Dual-publish first**:検証の前に署名を公開します。
+- **移行中にのみフェイルオープン**:一時的な互換性期間が明示され、期限が切れる。
+- **測定されたロールアウト**:テレメトリーの後で確認を強制して下さい安定した署名された出版を確認します。
+-**Fast rollback**: 根本原因が調査される間、符号なしの行動に戻るパスを保存します。
+
+ツイート 4) フェーズドタイムライン(歴史的)
+
+################################################################################################################################################################################################################################################################ フェーズ0 — 準備(完了)
+
+配達可能:
+- 生成されたキーと指紋を記録する署名
+- GitHubの秘密作成
+- リポジトリに公開鍵を追加
+- runbooks が承認(`security-signing-runbook.md`、このファイル)
+
+出口の基準:
+- レビュアーによって検証される重要な指紋
+- 保護された枝/ワークフロー制御は有効にしました
+
+################################################################################################################################################################################################################################################################ フェーズ1 — CI 署名機能、クライアントの執行なし (完了)
+
+実装:
+- `advisories/feed.json.sig`を作り出すために供給の印のステップ/ワークフローを加えて下さい
+- 任意に農産物 `advisories/checksums.json` + `.sig`の特長
+- CIがアーティファクトを公開する前に署名を検証することを確認してください
+
+また更新の展開:
+- `.sig`アーティファクトを`public/advisories/`にコピーする
+- `public/releases/latest/download/advisories/`のミラー`.sig`
+
+出口の基準:
+- すべてのフィード更新パスで正常に生成されたシグネチャ
+- アーティファクトには、ペイロードと署名のコンパニオンの両方が含まれている
+
+################################################################################################################################################################################################################################################################ フェーズ 2 — 消費者のデュアル読み取り/デュアル検証サポート(完了)
+
+消費者の実装:
+- `feed.json`と`feed.json.sig`を読みます
+- ピン留めされた公共のキーと確認して下さい
+- migration の窓の間に管理された一時的な署名されていないフォールバックを保って下さい
+
+検証:
+- リモート署名されたパスをテストして下さい
+- ローカル署名されたフォールバックパスをテストして下さい
+- 無効な署名拒否のテスト
+
+出口の基準:
+- 検証ロジックのリリースとテスト
+- 浸漬期間中に偽陽性検証の失敗はありません
+
+################################################################################################################################################################################################################################################################ フェーズ3 — 強化(完了)
+
+アクション:
+- デフォルトパスの一時的な署名されていないフォールバック動作を無効にします
+- `.sig`が欠落したときに失敗するCI /公開ゲートを追加します
+- リリースノートおよび文書の施行日を発表
+
+出口の基準:
+- すべてのプロダクションクライアントは、デフォルトでシグネチャを検証します
+- 標準的な設置流れの署名されていない供給の依存性無し
+
+################################################################################################################################################################################################################################################################ フェーズ 4 — 安定化(継続)
+
+アクション:
+- 最初のキー回転テーブルトップドリルを実行します
+- ロールバックテーブルトップドリルを実行
+- 簡単なレビューで移行を閉じる
+
+ツイート 5)ロールバックプラン
+
+## ロールバックトリガー
+
+以下のいずれかが発生した場合は、ロールバックを初期化します。
+- クライアント間でシグネチャ認証の失敗を持続
+- ワークフローの署名は、有効な署名を生成できません
+- 重要な妥協が疑われるが、置換キーはまだ展開されていない
+- 展開パスは、不一致したペイロード/署名ペアを公開します
+
+##ロールバックレベル
+
+## レベル 1 (必須): 検証バイパスウィンドウ, 署名された出版を維持
+
+使用時:署名は健康で、クライアント側の修飾子に欠陥があります。
+
+アクション:
+1。 クライアントリリースブランチで一時的な署名なしのアクセプタンス動作を再有効。
+2。 バイパスの明示的な有効期限でパッチリリースを出荷します。
+3。 認証ギャップを避けるためにパイプラインをアクティブに署名し続ける。
+
+回復ターゲット: 24–48h内の厳密な確認を元通りにして下さい。
+
+## レベル 2: パイプラインの注入、署名されていない供給を一時的にauthoritative署名しました
+
+いつ使用して下さい: 署名のパイプラインは不安定ですまたは不連続なアーティファクトを作り出します。
+
+アクション:
+1。 ワークフローの署名やステップの署名を無効にします。
+2. 既存のワークフローを介した`advisories/feed.json`を公開し続けます。
+3。 `.sig`アーティファクトを必要とするデプロイゲートを反転します。
+4。 未署名モードでのインシデントレコードを開き、時刻を追跡します。
+
+回復ターゲット:署名された出版ASAPを、理想的に <72h。
+
+##レベル3:フルリリースフリーズ
+
+いつ使う: リポジトリ/ワークフローの妥協や完全性が疑わしい。
+
+アクション:
+1。 フィードのミューテーションとデプロイのワークフローを再利用します。
+2。 アドバイザリーファイル/ワークフローの既知のコミットを復元します。
+3。 キーと認証情報を回転させます。
+4。 セキュリティレビューサインオフ後にパイプラインを再開します。
+
+##ロールバック後のロールフォワード
+
+- 根本原因を特定する
+- 回帰テスト/ゲートを追加
+- redeployの署名されたアーティファクト
+- インシデントの公開 + 修正要約
+
+ツイート 6)コミュニケーション計画
+
+執行およびロールバックのでき事のために、伝達します:
+- 変更点
+- 期待される演算子/クライアントアクション
+- 一時的な互換性モードの持続時間(もしあれば)
+- ユーザーの検証コマンド
+
+推奨チャンネル:
+- GitHubリリースノート
+- リポジトリ README/docsの更新
+- リポジトリの発行/インシデントレポート
+
+ツイート 7) ゴー/ノーゴーチェックリスト
+
+すべてが真の場合だけ行く:
+- ワークフローの成功率の署名は安定しています
+- 署名はすべての文書化されたフィードエンドポイントにミラーリングされます
+- リモート+ローカルフォールバックのためにテストされた消費者検証パス
+- ロールバック所有者が割り当てられ、到達可能
+- キーの回転プロシージャは少なくとも一度に乾燥した操業です
+
+## ソース参照
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml
+- スキル/クローセスイート/ホック/クローセ-アドバイザー/ハンドラー.ts
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- アドバイザリー/フィード.json
+- wiki/security-signing-runbook.md
diff --git a/wiki/ja/overview.md b/wiki/ja/overview.md
new file mode 100644
index 0000000..1e7a9d6
--- /dev/null
+++ b/wiki/ja/overview.md
@@ -0,0 +1,114 @@
+
+
+ツイート プロフィール
+
+## 目的
+- ClawSecは、公開WebカタログとOpenClawおよびNanoClaw環境用のインストール可能なセキュリティスキルを組み合わせたセキュリティ重視のリポジトリです。
+- - - コードベースは、静的ウェブサイトの公開、署名されたアドバイザリー配布、およびper-skill GitHubリリースパッケージの3つのデリバリーパスをサポートしています。
+- プライマリユーザーは、CIベースのセキュリティ自動化を実行しているエージェント・オペレータ、スキル・デベロッパー、メンテナーです。
+
+
+
+
+ツイート リポレイアウト
+| パス | ロール | ノート |
+| お問い合わせ |
+| `pages/`、`components/`、`App.tsx`、`index.tsx` | Vite + React UI | スキルカタログ、アドバイザリーフィード、詳細ページ お問い合わせ
+| `skills/` | セキュリティスキルパッケージ | 各スキルは`skill.json`、`SKILL.md`、オプションスクリプト/テスト/ドキュメントを持っています。 お問い合わせ
+| `advisories/` | リポジトリアドバイザリーチャンネル | 署名 `feed.json` + `feed.json.sig`と主要素材. お問い合わせ
+| `scripts/` | ローカルオートメーション | フィード/スキル、プレプッシュチェック、リリースヘルパーのポップアップ お問い合わせ
+| `.github/workflows/` | CI/CD パイプライン | CI、リリース、NVD ポーリング、コミュニティアドバイザリー摂取、ページ展開 お問い合わせ
+| `utils/` | パイソンユーティリティ | スキル検証とチェックサム包装ヘルパー お問い合わせ
+| `public/` | 静的資産の公開 | サイトメディア、ミラード・アドバイザリー、生成されたスキルアーティファクト。 お問い合わせ
+| `wiki/` | ドキュメンテーションハブ | アーキテクチャー・オペレーション・ランブック・互換性・検証ガイド お問い合わせ
+
+## エントリーポイント
+| エントリー | タイプ | 目的 |
+| お問い合わせ |
+| `index.tsx` | フロントエンドブーツ | `#root`にReactアプリをマウント お問い合わせ
+| `App.tsx` | フロントエンドルータ | 自宅・スキル・フィード・wikiページのルートマップの定義 お問い合わせ
+| `scripts/prepare-to-push.sh` | Devのワークフロー | プッシュ前にlint/type/build/securityのチェックを実行します。 お問い合わせ
+| `scripts/populate-local-feed.sh` | データブートストラップ | NVD から CVE をプルし、現地のアドバイザリーフィードを更新します。 お問い合わせ
+| `scripts/populate-local-skills.sh` | データブートストラップ | `public/skills/index.json` と 1 スキルチェックサムのビルド お問い合わせ
+| `scripts/generate-wiki-llms.mjs` | ドキュメントのエクスポート | `public/wiki/llms.txt` と 1 ページの wiki のエクスポートを生成します。 お問い合わせ
+| `.github/workflows/skill-release.yml` | リリースエントリー | ハンドルPR版-parity/dry-run checks and tag-based Packaging/signing/release お問い合わせ
+| `.github/workflows/poll-nvd-cves.yml` | フィード更新スケジュール | ポールズNVDとアップデートのアドバイザリー お問い合わせ
+
+## キーアーティファクト
+| アーティファクト | プロデュース | | コンセプト |
+| お問い合わせ |
+| `advisories/feed.json` | NVD 投票 + コミュニティアドバイザリーワークフロー | Web UI、clawsec-suite ホック、インストーラー お問い合わせ
+| `advisories/feed.json.sig` | ワークフローの署名 | スイート・アンド・ノークローのシグネチャ検証 お問い合わせ
+| `public/skills/index.json` | ワークフロー・ローカル・ポジュレート・スクリプトの展開 | `pages/SkillsCatalog.tsx` と `pages/SkillDetail.tsx` お問い合わせ
+| `public/wiki/llms.txt` + `public/wiki/**/llms.txt` | ウィキジェネレータスクリプト + ビルドホック | LLM-ready wiki エクスポート wiki UI からリンクされています。 お問い合わせ
+| `public/checksums.json` + `public/checksums.sig` | ワークフローの展開 | オペレータやランタイムのクライアントのための公開整合性アーティファクト. お問い合わせ
+| `release-assets/checksums.json` | スキルリリースワークフロー | 消費者がzipの完全性を検証するリリース お問い合わせ
+| `skills/*/skill.json` | スキル作者 | サイトカタログ作成・検証・リリースパイプライン お問い合わせ
+
+ツイート キーワークフロー
+- ローカルWeb開発: `npm install` は、`npm run dev` です。
+- ローカルセキュリティデータプレビュー: `./scripts/populate-local-skills.sh` と `./scripts/populate-local-feed.sh` をロードする前に `/skills` と `/feed` ページを実行します。
+- プレパス品質ゲート:`./scripts/prepare-to-push.sh`(オプションで`--fix`)を実行します。
+- スキルのライフサイクル:`skills//`を編集し、`python utils/validate_skill.py`で検証し、`-vX.Y.Z`にタグを付けてリリースワークフローをトリガーします。
+- アドバイザリーのライフサイクル:NVDのポールおよび問題ラベルに基づくコミュニティの摂取量は、同じ署名されたフィードに結合します。
+
+## サンプルスニペット
+```bash
+# local UI + locally populated data
+npm install
+./scripts/populate-local-skills.sh
+./scripts/populate-local-feed.sh --days 120
+npm run dev
+```
+
+```bash
+# canonical TypeScript quality checks used by CI
+npx eslint . --ext .ts,.tsx,.js,.jsx,.mjs --max-warnings 0
+npx tsc --noEmit
+npm run build
+```
+
+ツイート 開始場所
+- `README.md`は、製品位置決めとインストールパスです。
+- `App.tsx` と `pages/` を開き、ユーザーフェーシングの動作を把握します。
+- `skills/clawsec-suite/skill.json`を開き、スイート契約と組込みコンポーネントを理解します。
+- `.github/workflows/ci.yml`、`.github/workflows/pages-verify.yml`、`.github/workflows/skill-release.yml`、`.github/workflows/deploy-pages.yml`、および`.github/workflows/wiki-sync.yml`の生産行動のレビュー。
+
+ツイート ナビゲートする方法
+- `pages/`にUIの動作が集中しています。`components/`にビジュアルラッパーが座っています。
+- スキル固有のロジックは、`skills/`のフォルダによって分離されます。各フォルダには独自のスクリプト/テスト/ドキュメントが含まれています。
+- フィード処理は、リポジトリフィードファイル、ワークフローの更新、ランタイムの消費者(`clawsec-suite`/`clawsec-nanoclaw`)の3つのレイヤーに表示されます。
+- `scripts/`およびワークフローYAMLファイルで動作品質ゲートが稼働します。
+- 生成のトレースやベースラインを更新するには、`wiki/GENERATION.md`から始まり、モジュールページにブランチします。
+
+## 共通ピッタフォール
+- 設定パス env vars で literal のホームトークン (たとえば `\$HOME`) を使うと、パス検証の失敗をトリガーできます。
+- SPA ルートから JSON を取得すると、ステータス 200 で HTML を返すことができます。このページガードは空の状態として扱います。
+- 移行の互換性のために、フィードバイパスモード(`CLAWSEC_ALLOW_UNSIGNED_FEED=1`)が存在し、安定した状態では使用しないでください。
+- `skill.json`と`SKILL.md`のフロントマッタ間のバージョンのパリティを期待するスキルリリース自動化。
+- 一部のスクリプトは、POSIX シェル指向です。 Windows ユーザーは、PowerShell の同等体または WSL を好む必要があります。
+
+## 更新ノート
+- 2026-02-26: 削除されたルート`docs/`ディレクトリの代わりに、`wiki/`で運用文書を指すためにリポジトリレイアウトを更新しました。
+
+## ソース参照
+- README.mdの
+- パッケージ.json
+- App.tsxアプリ
+- インデックス.tsx
+- ページ/ホーム.tsx
+- ページ/SkillsCatalog.tsx
+- ページ/SkillDetail.tsx
+- ページ/フィードSetup.tsx
+- スクリプト/prepare-to-push.sh
+- スクリプト/populate-local-feed.sh
+- スクリプト/populate-local-skills.sh
+- スキル/ clawsec-suite/skill.json
+- .github/workflows/ci.yml
+- .github/workflows/pages-verify.yml
+- .github/workflows/skill-release.yml
+- .github/workflows/deploy-pages.yml
+- .github/workflows/wiki-sync.yml
diff --git a/wiki/ja/platform-verification.md b/wiki/ja/platform-verification.md
new file mode 100644
index 0000000..d4f1953
--- /dev/null
+++ b/wiki/ja/platform-verification.md
@@ -0,0 +1,103 @@
+
+
+# プラットフォーム検証チェックリスト
+
+このチェックリストを使用して、変更後のポータビリティとパス処理の動作を検証します。
+
+## Linux 検証
+
+1。 コアノードのテストを実行します。
+ ```bash
+ node skills/clawsec-suite/test/path_resolution.test.mjs
+ node skills/clawsec-suite/test/guarded_install.test.mjs
+ node skills/clawsec-suite/test/advisory_suppression.test.mjs
+ node skills/openclaw-audit-watchdog/test/suppression_config.test.mjs
+ ```
+期待:すべてのテストパス。
+
+2。 `$HOME`パスの受け入れを検証しません。
+ ```bash
+ CLAWSEC_LOCAL_FEED='\$HOME/advisories/feed.json' \
+ node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+ ```
+期待:`Unexpanded home token`エラーでゼロを終了します。
+
+3. `$HOME`の拡張機能を検証:
+ ```bash
+ HOME=/tmp/clawsec-home node skills/clawsec-suite/test/path_resolution.test.mjs
+ ```
+期待:`$HOME`拡張テストパス
+
+# macOS 検証
+
+1。 Linux と同じ Node テスト スイートを実行します。
+2。 OpenSSLツーリングパスの仮定が文書化されていることを確認します。
+- LibreSSL/OpenSSL のバリエーションを使用する場合は、docs からテストされたコマンドフォームを使用することを確認してください。
+3。 設定パスでチルドの拡張を確認します。
+ ```bash
+ OPENCLAW_AUDIT_CONFIG=~/.openclaw/security-audit.json \
+ node skills/openclaw-audit-watchdog/scripts/load_suppression_config.mjs --enable-suppressions
+ ```
+期待される: パスは正しく解決します (または拡張された場所での明確なファイルではなく、エラー)。
+
+## Windowsの検証(PowerShell)
+
+1。 ノードテストを実行します。
+ ```powershell
+ node skills/clawsec-suite/test/path_resolution.test.mjs
+ node skills/clawsec-suite/test/guarded_install.test.mjs
+ node skills/clawsec-suite/test/advisory_suppression.test.mjs
+ ```
+期待:すべてのパス。
+
+2。 電力を検証 Shell env パス拡張動作:
+ ```powershell
+ $env:CLAWSEC_LOCAL_FEED = '$env:USERPROFILE\advisories\feed.json'
+ node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+ ```
+期待: パストークンが展開/正規化されるか、ターゲットファイルが不足している場合、クリアエラーで失敗します。
+
+3。 エスケープされたリテラルトークン拒否を確認します。
+ ```powershell
+ $env:CLAWSEC_LOCAL_FEED = '\$HOME\advisories\feed.json'
+ node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+ ```
+期待: `Unexpanded home token` のエラー、Liteal `$HOME` のディレクトリ作成なし。
+
+ツイート ライン・エンド・サンティ
+
+1。 LFポリシーの提示を確認する:
+ ```bash
+ test -f .gitattributes && grep -n "eol=lf" .gitattributes
+ ```
+期待:スクリプト/コンフィグファイルパターンはLFを強制します。
+
+2。 CRLF-prone のチェックアウト後、スクリプトは引き続き解析します。
+ ```bash
+ bash -n scripts/populate-local-feed.sh
+ bash -n scripts/populate-local-skills.sh
+ ```
+期待される:`^M`のshbang/parseの間違い無し。
+
+## Explicit Bug Check: 文字無し `$HOME` ディレクトリ作成
+
+1。 リテラル/エスケープされたトークンを持つパスを設定します。
+2。 セットアップ/インストールコマンドを実行します。
+3。 コマンドがトークンエラーで初期に失敗することを確認します。
+4. `$HOME` のセグメントディレクトリは、作業ディレクトリで作成されていないことを確認します。
+
+期待される結果:**Liteal `$HOME` を含むディレクトリはサポートされたセットアップスクリプトによって作成されます。 メニュー
+
+## ソース参照
+- .gitattributesの
+- スクリプト/populate-local-feed.sh
+- スクリプト/populate-local-skills.sh
+- スキル/clawsec-suite/test/path_resolution.test.mjs
+- スキル/ clawsec-suite/test/guarded_install.test.mjs
+- スキル/ clawsec-suite/test/advisory_suppression.test.mjs
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スキル/openclaw-audit-watchdog/scripts/load_suppression_config.mjs
+- スキル/openclaw-audit-watchdog/test/suppression_config.test.mjs
diff --git a/wiki/ja/remediation-plan.md b/wiki/ja/remediation-plan.md
new file mode 100644
index 0000000..0f95334
--- /dev/null
+++ b/wiki/ja/remediation-plan.md
@@ -0,0 +1,89 @@
+
+
+# クロスプラットフォームの修復計画
+
+ツイート フェーズ1:リスク閉鎖の即時化(完了)
+
+##マイルストーン
+- 高リスクランタイム/インストールパスで明示的なホームパス拡張+疑わしいトークン拒否を実行します。
+- パスの拡張とエスケープトケン拒否のための回帰テストを追加します。
+- `.gitattributes` LFポリシーを追加します。
+- Node lint/type/build CI のカバレッジを Linux/macOS/Windows に拡張します。
+- シェル固有のガイダンスとリテラル`$HOME`のトラブルシューティングでインストールドキュメントを更新します。
+
+## アウトカム
+- `$HOME`パス伝搬のバグをソースで解決
+- コアアドバイザリー/インストールパスコンフィグが無効なパストークンで高速に失敗しました。
+
+お問い合わせ
+
+ツイート フェーズ2:批判的ワークフローのためのWindowsのパリティ(次)
+
+### クイック勝利
+- パワーを追加 最も使用されるマニュアルのインストール/チェックコマンドのシェルの同等物:
+- `skills/clawsec-suite/SKILL.md`
+- `skills/openclaw-audit-watchdog/SKILL.md`
+- `README.md`
+- 欠けているツールを検出し、OS固有のインストールのヒントを印刷するために、軽量`scripts/preflight.mjs`を追加します。
+
+##マイルストーン
+- ネイティブパワー スイートのセットアップとアドバイザリーのホックのためのシェルの指示。
+- シェルスクリプトが無効なWSL/Git Bashフォールバックが文書化されました。
+
+お問い合わせ
+
+ツイート フェーズ3:POSIXを削減 貝の表面(Deeper Refactor)
+
+##Refactor ターゲット
+- `scripts/populate-local-feed.sh`
+- `scripts/populate-local-skills.sh`
+- `scripts/release-skill.sh`
+
+### アプローチ
+- `jq/sed/awk/find/chmod`パイプラインの依存性を除去するためにNode/Pythonで再実装重要なパス。
+- 後方互換性のためのシェルラッパーを保存します。新しいクロスプラットフォームの実装へのルート。
+
+##マイグレーションノート
+- 古いスクリプトのエントリは、少なくとも1つのマイナーリリースのラッパーとして設定します。
+- 正確なマイグレーションコマンドで非推奨警告を省略します。
+
+お問い合わせ
+
+ツイート フェーズ4:CIの堅くなり、主張する検証
+
+##マイルストーン
+- ノード行列(Linux/macOS/Windows)を必須チェックとして保持します。
+- パスの処理を取付けるための対象となるWindowsの煙テストを加えて下さい。
+- 関連するOpenSSLコマンドの互換性メモのmacOSチェックを追加します。
+
+郵便番号 テスト戦略
+- ローカル:
+- ノードテストスイートを実行し、パスの拡張/抑制/インストール動作をカバーします。
+- 変更されたスクリプトの構文チェックを実行します。
+- CI:
+- マトリックスノードは+ガードドインストーラ/抑制/パステストをチェックします。
+- Linuxのみのセキュリティスキャンは残っていますが、明示的にLinux-scopedとしてマークされています。
+
+お問い合わせ
+
+##ロールアウト/リリース検討
+
+- - - このパッチセットで導入されたインターフェイスの変更を破らない; 動作は無効/未公開のパストークンのみ厳格です。
+- リリースノートで通信:
+- パストークンの検証が強化されました
+- 無効な引用符 env 値を修正する方法
+- パワー シェル例ライブ
+
+## ソース参照
+- .gitattributesの
+- .github/workflows/ci.yml
+- スクリプト/populate-local-feed.sh
+- スクリプト/populate-local-skills.sh
+- スクリプト/リリース-skill.sh
+- スキル/クローセスイート/ホック/クローセ-アドバイザー/ハンドラー.ts
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スキル/openclaw-audit-watchdog/scripts/load_suppression_config.mjs
+- wiki/platform-verification.md の
diff --git a/wiki/ja/security-signing-runbook.md b/wiki/ja/security-signing-runbook.md
new file mode 100644
index 0000000..adb1532
--- /dev/null
+++ b/wiki/ja/security-signing-runbook.md
@@ -0,0 +1,241 @@
+
+
+# ClawSec 署名操作 Runbook
+
+> 参照実装: `clawsec-suite`（OpenClawスイート）
+
+ツイート 1) 目的
+
+この runbook は、ClawSec リポジトリに暗号署名を導入および実行するための運用手順を定義します。
+
+それはカバーします:
+- キー生成
+- GitHubの秘密管理
+- ワークフローの統合の署名
+- キーの回転およびrevocation
+- インシデント対応
+
+ツイート 2) 現在の作動状態(重要)
+
+`main`では、アドバイザリーおよびリリースチャネルは、デフォルトで署名および検証されています。
+
+- フィードライター:
+- `.github/workflows/poll-nvd-cves.yml`は`advisories/feed.json`を更新し、`advisories/feed.json.sig`に署名します
+- `.github/workflows/community-advisory.yml`は承認された問題のレポートのために同じことをします
+- 署名されたフィードアーティファクトを`skills/clawsec-feed/advisories/`に同期する
+- フィード公開パス:
+- `.github/workflows/deploy-pages.yml`公開 `public/advisories/feed.json` + `.sig`の特長
+- `public/checksums.json` + `public/checksums.sig`を生成し、署名します
+- `public/signing-public.pem`および`public/advisories/feed-signing-public.pem`としてcanonicalキーを出版して下さい
+- `public/releases/latest/download/`(`feed.json`、`feed.json.sig`、`checksums.json`、`checksums.sig`、`signing-public.pem`を含む)に基づく互換性のアーティファクトをミラーリング
+- 供給の消費者:
+- `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`
+- `skills/clawsec-suite/scripts/guarded_skill_install.mjs`
+- `skills/clawsec-nanoclaw/lib/advisories.ts`
+- デフォルトのフィードURLは`https://clawsec.prompt.security/advisories/feed.json`です
+
+符号なしモードは、明示的な互換性バイパス(`CLAWSEC_ALLOW_UNSIGNED_FEED=1`)のままであり、安定した状態の動作モデルではありません。
+
+ツイート 3) ターゲット署名されたアーティファクト
+
+##アドバイザリーフィードチャネル
+- `advisories/feed.json` (ペイロード)
+- `advisories/feed.json.sig`(Ed25519署名を取り外す)
+- `advisories/feed-signing-public.pem`(ピンキー公開)
+
+################################################################################################################################################################################################################################################################ リリースアーティファクトチャンネル
+- `/signing-public.pem`
+- `/signing-public.pem`
+- `/signing-public.pem`
+
+ツイート 4) 主な役割およびcustody
+
+- **セキュリティ所有者**:重要なライフサイクルの変更とインシデントアクションを承認します。
+- **プラットフォーム所有者**:ワークフローとGitHubの秘密を保持します。
+-**Reviewer**:PR /リリースで指紋を検証します。
+
+ポリシー:
+- 秘密鍵は決して約束しません
+- 公開鍵はコミットされ、コードレビューされます
+- 信頼できるオペレータのワークステーションかHSM支えられた環境で主生成は起こります
+
+ツイート 5)キー生成(Ed25519)
+
+ツイート 安全なワークステーションから実行します。 共有CIランナーで実行しないでください。
+
+```bash
+# Feed signing keypair
+openssl genpkey -algorithm Ed25519 -out feed-signing-private.pem
+openssl pkey -in feed-signing-private.pem -pubout -out feed-signing-public.pem
+
+# Release checksums signing keypair (optional separate key)
+openssl genpkey -algorithm Ed25519 -out release-signing-private.pem
+openssl pkey -in release-signing-private.pem -pubout -out release-signing-public.pem
+```
+
+指紋の生成(チケット/変更記録の保存):
+
+```bash
+openssl pkey -pubin -in feed-signing-public.pem -outform DER | shasum -a 256
+openssl pkey -pubin -in release-signing-public.pem -outform DER | shasum -a 256
+```
+
+出版前の任意テスト署名:
+
+```bash
+echo '{"probe":"ok"}' > /tmp/probe.json
+openssl pkeyutl -sign -rawin -inkey feed-signing-private.pem -in /tmp/probe.json -out /tmp/probe.sig.bin
+openssl base64 -A -in /tmp/probe.sig.bin -out /tmp/probe.sig
+openssl base64 -d -A -in /tmp/probe.sig -out /tmp/probe.sig.bin
+openssl pkeyutl -verify -rawin -pubin -inkey feed-signing-public.pem -in /tmp/probe.json -sigfile /tmp/probe.sig.bin
+```
+
+ツイート 6) GitHubの秘密のセットアップ
+
+郵便番号 必須の秘密
+
+- `CLAWSEC_SIGNING_PRIVATE_KEY` — PEMエンコードEd25519プライベートキー(フィードとリリース署名の両方に使用されます)
+- プライベートキーが暗号化されている場合、`CLAWSEC_SIGNING_PRIVATE_KEY_PASSPHRASE` — (オプション) パスフレーズ
+
+### 手順
+
+1。 [Repo 設定] → [秘密と変数] → [アクション] → [新しいリポジトリ] に移動します。
+2. ヘッダー/フッターを含む完全なPEMを貼って下さい。
+3。 プリファー GitHub **環境の秘密** (必要な査読者と) 可能な場合のワークフロースキャッピング。
+4。 レコード変更チケット:
+- 秘密名
+- クリエイター
+- 制作時間
+- 主指紋
+
+################################################################################################################################################################################################################################################################ 推奨環境保護
+
+- 署名の秘密を使用できるワークフローの手動承認が必要です。
+- 保護されたワークフローを編集できる制限
+- `main`のブランチ保護を有効にし、ワークフロー変更のレビューが必要です。
+
+ツイート 7) ワークフロー統合ポイント
+
+このリポジトリは、ポスト・ミュテーション、事前公開制御として署名を強制します。
+
+## フィードパイプライン
+
+現在の供給の変異ポイント:
+- `.github/workflows/community-advisory.yml`
+- `advisories/feed.json`
+
+現在の動作:
+- ワークフローステップは`advisories/feed.json`を`advisories/feed.json.sig`に署名します
+- アクションの署名は、ワークフローの実行中に生成された署名を検証します
+- 署名されたアーティファクトはPRのオートメーションによって託されます
+
+郵便番号 ページパイプライン
+
+現在のパブリッシャー:
+- `public/advisories/`
+
+現在の動作:
+- `public/advisories/`にペイロード/署名をコピー
+- `public/checksums.json`と`public/checksums.sig`を生成します
+- `public/signing-public.pem`と`public/advisories/feed-signing-public.pem`への署名キーを公開
+- アドバイザリー+シグネチャ/チェックサム/キーコンパニオンを`public/releases/latest/download/`互換パスにミラーリング
+
+################################################################################################################################################################################################################################################################ スキルリリースパイプライン(推奨硬化)
+
+現在の解放の発電機:
+- `checksums.json`
+
+現在の動作:
+- `checksums.json` を作成し、`checksums.sig` に署名し、公開する前に署名を検証します。
+- リリースアセットに`signing-public.pem`が含まれています
+- 生成された公開鍵の指紋を正規キー素材に対して検証
+
+ツイート 8) 回転ポリシーとランブック
+
+## 回転アカデミー
+- ルーチン:90日ごとに(または厳格なorgポリシー)。
+- 即時:疑わしい暴露、不正なワークフロー変更、または明示されていない署名不一致。
+
+## ルーチン回転ステップ
+
+1。 新しいキーペアを生成します。
+2。 パブリックキーファイルと指紋のドキュメントを更新するPRを開きます。
+3。 GitHub シークレットとして新しい秘密鍵を追加します。
+4。 新しいキーを使用するワークフローの変更をマージします。
+5。 最新のフィード/リリースマニフェストを再署名します。
+6。 CI および外部クライアントの検証を検証します。
+7。 古い秘密鍵を削除します。
+8。 過去の公開鍵の参照は、履歴検証に必要な限りのみ保持します。
+
+## 取消ステップ
+
+1。 妥協されたキーを使用してワークフローを無効にします。
+2. 承認されたGitHubの秘密を削除します。
+3。 取消しメモと公開鍵をコミットします。
+4。 交換キーで最新のアーティファクトを再署名します。
+5。 タイムスタンプとインパクトのあるウィンドウでインシデントアドバイザリーを発行します。
+
+ツイート 9) インシデント応答 Playbook(署名固有の)
+
+## トリガー
+- 新規公開フィード/リリースのシグネチャ検証が失敗
+- 未知のコミット/ワークフローは署名パスに触れる編集します
+- 漏れたキー素材、誤ったロギング、または疑わしいシークレットアクセス
+
+###重度ガイド
+-**SEV-1**:鍵の浸入確認または悪意のある署名されたペイロードが公開
+- **SEV-2**:未知の原因で検証障害
+- **SEV-3**: 手続き非遵守、活動的な妥協無し
+
+郵便番号 応答フェーズ
+
+1。 **条件* * 必須
+- ワークフローの署名/公開を一時停止
+- 認証が未認証の場合、さらなるフィードマージをブロック
+2. **調査**
+- ワークフローの実行ログのレビュー
+- `.github/workflows/`、`advisories/`、および主要なファイルに影響を与える検討のコミット
+- ファースト・ベイド・タイムスタンプおよび影響を受けたアーティファクトを決定する
+3。 **取引**
+- 回転/回転調整キー(s)
+- 既知のコミットから信頼できるアーティファクトを復元する
+4。 **回復**
+- 再署名のアーティファクト
+- redeployページ/リリース
+- 独立したクライアントチェックで確認
+5。 **郵便番号* * 必須
+- タイムラインと修正要約を公開
+- 制御をきつく締めて下さい(眺めのゲート、保護された環境、秘密の規模)
+
+#10 監査証拠チェックリスト
+
+各リリースサイクルまたはフィード署名実行の場合、以下を保持します。
+- ワークフロー実行 URL とコミット SHA
+- 使用中のサイダーのキー指紋
+- 検証結果ログ
+- オペレータ/査読者の承認
+- 例外かバイパスの合理
+
+#11) 厳格なポリシー変更前の最小受け入れ基準
+
+ポリシーをさらに締める前に(例えば、互換性バイパスパスのパスを削除):
+- 署名されたアーティファクトは少なくとも2週のために一貫して作り出されます
+- パイプラインミラーのシグネチャーコンをデプロイする
+- 1つのロールバックのドリルおよび1つの主回転ドリルは首尾よく完了しました
+- インシデント対応のオンコールオーナーが特定および文書化
+
+## ソース参照
+- アドバイザリー/フィード.json
+- アドバイザリー/フィード.json.sig
+- アドバイザリー/フィード署名-public.pem
+- clawsec-signing-public.pem
+- .github/actions/sign-and-verify/action.yml
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml
+- .github/workflows/skill-release.yml
+- スクリプト/ci/verify_signing_key_consistency.sh
+- wiki/migration-signed-feed.md
diff --git a/wiki/ja/security.md b/wiki/ja/security.md
new file mode 100644
index 0000000..30be001
--- /dev/null
+++ b/wiki/ja/security.md
@@ -0,0 +1,83 @@
+
+
+ツイート セキュリティ
+
+##セキュリティモデルの概要
+- ClawSec は、コンテンツの配布 (署名されたアーティファクト) とランタイムの動作 (管理者のゲート、完全性監視) の両方を保護します。
+- Trust アンカーは、リポジトリにコミットし、ワークフロー生成された出力に対して検証された公開鍵をピン留めします。
+- Runtime 消費者は、明示的なマイグレーションバイパスフラグを使用して、検証優先動作にデフォルトでデフォルトで設定します。
+
+## 暗号化制御
+| 制御 | 機構 | 位置 |
+| お問い合わせ |
+お問い合わせ フィード認証 | Ed25519 は署名を取り外す (`feed.json.sig`) | アドバイザリーワークフロー + 消費者検証ライブラリ お問い合わせ
+| アーティファクトの完全性 | SHA-256チェックサムマニフェスト(`checksums.json`) | スキルリリースとページ展開ワークフロー お問い合わせ
+お問い合わせ 鍵の一貫性 | ドキュメント全体の指紋比較 + 正式PEM | `scripts/ci/verify_signing_key_consistency.sh`. お問い合わせ
+| シグネチャー検証アクション | CIでのコンポジットサイン+検証アクション | `.github/actions/sign-and-verify/action.yml` お問い合わせ
+
+#ランタイムの執行制御
+| 制御 | コンポーネント | 効果 |
+| お問い合わせ |
+| アドバイザリーホークギャティング | `clawsec-advisory-guardian` | マッチングアドバイザリーに基づく注意・注意深い指導 お問い合わせ
+| ダブルカンファレンスインストーラー | `guarded_skill_install.mjs` | `42`を終了 マッチングアドバイザリーの明示的な確認まで お問い合わせ
+| 評判の延長 | `clawsec-clawhub-checker` | インストール前の追加リスクスコアリング お問い合わせ
+| ナノクローシグネチャーゲート | `skill-signature-handler.ts` + MCPツール | ブロック改ざん・荷役パッケージをポリシーでインストールします。 お問い合わせ
+| 整合性ベースラインモニター | `soul-guardian` + NanoClaw 整合性モニター | ドリフト検知・検疫・復元・監査可能な履歴 お問い合わせ
+
+## サプライチェーンとCIコントロール
+- CI実行 トリビー、npm 監査、CodeQL、およびスコアカードワークフロー。
+- `gitleaks`がインストールされているときにローカルプレパスチェックが`gitleaks detect`を実行できます。
+- リリースワークフローは、パッケージの前にSBOMファイルの存在を検証します。
+- ワークフローをデプロイすると、生成された署名キーフィンガープリントをキャノンキー素材に対して検証します。
+- リリースドキュメントには、ダウンストリームの消費者向けの手動検証コマンドが含まれます。
+
+## インシデントとローテーションの Playbooks
+- `wiki/security-signing-runbook.md`は、キー生成、クラスト、回転、およびインシデントフェーズを定義します。
+- `wiki/migration-signed-feed.md`は段階的な執行およびロールバックのレベルを定義します。
+- ロールバックパスは、署名された公開を優先順位付けし、可能かつ任意のバイパスをタイムボックス化します。
+
+## サンプルスニペット
+```bash
+# verify canonical public key fingerprint
+openssl pkey -pubin -in clawsec-signing-public.pem -outform DER | shasum -a 256
+```
+
+```bash
+# run repo key-consistency guardrail used in CI
+./scripts/ci/verify_signing_key_consistency.sh
+```
+
+#既知のセキュリティトレードオフ
+- 符号なしの互換性モードは保証を減らすことができ、移行が完了したら無効にする必要があります。
+- バックワードの互換性のために署名されていないレガシーチェックサムアセットを許容するパスをいくつかデプロイします。
+- 評判は外的な工具細工の出力に依存し、ヒューリスティック偽陽性/負を含むかもしれません。
+- ローカルスクリプトは、環境の信頼を継承します。 侵害されたローカルシェルは、オペレータのワークフローをサブバートできます。
+
+## 困難な機会
+- 移行の安定化後に署名されていない互換性フラグを削除します。
+- すべてのミラーリングされた解放ファイルのための決定的なチェックサム/signatureの確認を拡大して下さい。
+- ワークフローレベルのシグネチャー障害シナリオに明示的なテストを追加します。
+- アドバイザリー・フェッチ/検証の失敗に対するランタイムテレメトリーを増加させ、インシデント・トライを簡素化します。
+
+## 更新ノート
+- 2026-02-26: `docs/`ファイルをroot `wiki/`の操作ページ専用の署名とマイグレーションの参照をリセットしました。
+
+## ソース参照
+- セキュリティ.md
+- wiki/security-signing-runbook.md
+- wiki/migration-signed-feed.md
+- スクリプト/ci/verify_signing_key_consistency.sh
+- .github/actions/sign-and-verify/action.yml
+- .github/workflows/poll-nvd-cves.yml
+- .github/workflows/community-advisory.yml
+- .github/workflows/skill-release.yml
+- .github/workflows/deploy-pages.yml
+- スキル/ clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs
+- スキル/clawsec-suite/scripts/guarded_skill_install.mjs
+- スキル/clawsec-clawhub-checker/scripts/enhanced_guarded_install.mjs
+- スキル/ロシア語/スクリプト/soul_guardian.py
+- スキル/ clawsec-nanoclaw/host-services/skill-signature-handler.ts
+- スキル/クローセ・ナンクロー/ガーディアン/積分僧侶。ts
diff --git a/wiki/ja/testing.md b/wiki/ja/testing.md
new file mode 100644
index 0000000..3111f44
--- /dev/null
+++ b/wiki/ja/testing.md
@@ -0,0 +1,82 @@
+
+
+# テスト
+
+## テスト戦略
+- - - リポジトリは、単一のルート`npm test`コマンドではなくレイヤ認証を使用します。
+- 中心の信任はlint/type/buildのゲートと巧みなローカルから来ます ノードテストスイート。
+- Python とシェルツーリングは、専用の lint/security チェックで検証されます。
+- ワークフローパイプラインは、ローカルプリパスオートメーションで使用される同じコマンドクラスを実行します。
+
+## 検証レイヤー
+| レイヤー | コマンド | スコープ |
+| お問い合わせ |
+| フロントエンド/静的チェック | ESLint + `tsc --noEmit` + `npm run build` | TS/TSX の正しさと生存性の構築 お問い合わせ
+| スキルユニットテスト | `node skills//test/*.test.mjs` | 署名・マッチング・抑制・インストーラー契約 お問い合わせ
+| Pythonの品質 | `ruff check utils/`、`bandit -r utils/ -ll` | ユーティリティの正確性とセキュリティのパターン お問い合わせ
+| シェル/スクリプトの品質 | ShellCheck + 手動スクリプトスモーク実行 | スクリプト衛生とコマンドの堅牢性。 お問い合わせ
+| CIセキュリティスキャン | トライビー、npm監査、CodeQL、スコアカード | 依存性、構成、およびサプライチェーンのセキュリティ姿勢。 お問い合わせ
+| ローカルプレパスセキュリティスキャン | `scripts/prepare-to-push.sh`経由のオプション`gitleaks detect` | プッシュ前のシークレットリーク検出 お問い合わせ
+
+##スキルテストマトリックス
+| スキル | テストファイル | プライマリフォーカス |
+| お問い合わせ |
+| `clawsec-suite` | `feed_verification`、`guarded_install`、`path_resolution`、ファズテスト | 署名チェック、アドバイザリーギャング、パスセーフティ、マッチング堅牢性 お問い合わせ
+| `openclaw-audit-watchdog` | 抑制設定・レンダリングテスト | 解析・抑制動作の設定、レポートのフォーマット お問い合わせ
+| `clawsec-clawhub-checker` | `reputation_check.test.mjs` | 入力検証と評判のゲーミング動作. お問い合わせ
+
+## CIワークフローカバレッジ
+| ワークフロー | トリガー | 主旨 お問い合わせ
+| お問い合わせ |
+| `ci.yml` | PR/push to `main` | リント/タイプ/ビルド、Pythonチェック、セキュリティスキャン、スキルテスト お問い合わせ
+| `codeql.yml` | PR/push/schedule | JS/TS 静的セキュリティ解析 お問い合わせ
+| `scorecard.yml` | スケジュール・出演 | サプライチェーン姿勢報告・SARIFアップロード お問い合わせ
+| `skill-release.yml` | タグ + 広報 | 版画・リリースアーティファクト検証 お問い合わせ
+
+## ローカルテストコマンド
+```bash
+# baseline frontend + config checks
+npx eslint . --ext .ts,.tsx,.js,.jsx,.mjs --max-warnings 0
+npx tsc --noEmit
+npm run build
+```
+
+```bash
+# representative skill tests
+node skills/clawsec-suite/test/feed_verification.test.mjs
+node skills/clawsec-suite/test/guarded_install.test.mjs
+node skills/openclaw-audit-watchdog/test/suppression_config.test.mjs
+```
+
+## 時計の失敗パターン
+- 署名/テストフィクスチャーは、予想されたファイルが意図的に再生されると、キー/ペイロードの不一致から失敗することができます。
+- エスケープされたホームトークンに意図的に失敗するパスレゾリューションテスト。この動作は期待され、セキュリティ関連性があります。
+- `openclaw`または`clawhub`バイナリに依存するローカルスクリプトは、それらのCLIが存在しない環境で失敗する可能性があります。
+- デプロイ/リリース ロジックは、秘密やワークフローのパーミッションが異なる場合、CIで失敗したときにローカルに渡すことができます。
+
+## 推奨テスト注文
+1. 完全なローカル ゲートのための `./scripts/prepare-to-push.sh` を実行して下さい。
+2。 直接影響を受けたスキルローカルテストを実行します。
+3。 フィード/署名変更のため、スイート検証テストを最初に実行します(`feed_verification`、`guarded_install`)。
+4。 ワークフローやリリースの変更については、`scripts/validate-release-links.sh`とキーの一貫性スクリプトを実行します。
+
+## 更新ノート
+- 2026-02-26: 移行された`wiki/platform-verification.md`チェックリストにソースの参照を更新しました。
+
+## ソース参照
+- AGENTS.mdの
+- スクリプト/prepare-to-push.sh
+- スクリプト/validate-release-links.sh
+- .github/workflows/ci.yml
+- .github/workflows/codeql.yml
+- .github/workflows/scorecard.yml
+- .github/workflows/skill-release.yml
+- スキル/clawsec-suite/test/feed_verification.test.mjs
+- スキル/ clawsec-suite/test/guarded_install.test.mjs
+- スキル/clawsec-suite/test/path_resolution.test.mjs
+- スキル/openclaw-audit-watchdog/test/suppression_config.test.mjs
+- スキル/clawsec-clawhub-checker/test/reputation_check.test.mjs
+- wiki/platform-verification.md の
diff --git a/wiki/ja/workflow.md b/wiki/ja/workflow.md
new file mode 100644
index 0000000..a84cb53
--- /dev/null
+++ b/wiki/ja/workflow.md
@@ -0,0 +1,87 @@
+
+
+# ワークフロー
+
+## エンドツーエンドのライフサイクル
+- 開発は、ローカルコーディング+ローカルデータ人口と現実的なUIプレビューから始まります。
+- PR CI は、品質/セキュリティとスキルテストスイートを検証します。
+- PR Pages-verifyは、公開せずに生産ビルド/署名の動作を検証します。
+- タグ主導のリリースワークフローパッケージとスキルアーティファクトの署名。
+- ページは、ワークフローミラーのリリース/アドバイザーのアーティファクトをデプロイし、静的なサイトを公開します。
+- Wiki-sync ワークフローでは、`wiki/` のドキュメントを GitHub Wiki に公開しています。
+- スケジュールされたワークフローは、アドバイザリーフィードとサプライチェーンの可視性を継続的に強化します。
+
+## 第一次ワークフローマップ
+| ワークフロー | トリガー | 主な工程 |
+| お問い合わせ |
+| CI | PR/push to `main` | リント、タイプチェック、ビルド、Pythonチェック、セキュリティスキャン、スキルテスト。 お問い合わせ
+お問い合わせ ページの検証 | `main`へのPR | ページのアーティファクトを構築し、サインアウトプットを検証 (公開なし). お問い合わせ
+| 有料NVD CVE | 日頃のcron + マニュアルディスパッチ | フェッチCVE、トランス/デプス、アップデートフィード、サインアーティファクト、PR変更。 お問い合わせ
+| プロセスコミュニティアドバイザリー | 課題ラベル `advisory-approved` | 課題フォーム | 課題フォーム | 諮問・署名フィードの作成・広報オープン・コメント問題 お問い合わせ
+| スキルリリース | スキルタグ+メタデータPR変更 | PR: バージョン・パーティー + ドライランチェック、タグ: パッケージ・サイン・公開リリースアセット お問い合わせ
+| 展開ページ | CI/Release/手動ディスパッチの成功 | リリース、ミラーアセットの発見、パブリックアドバイザリー/チェックサムの署名、展開サイト お問い合わせ
+| シンクウィキ | `main` に `wiki/**` に触れる `wiki/` を `.wiki.git` に同期し、 `INDEX.md` から `Home.md` を生成します。 お問い合わせ
+
+## ローカルオペレーターワークフロー
+| ステップ | コマンド | アウトカム |
+| お問い合わせ |
+| デプス設置 | `npm install` | 既読のローカル環境 お問い合わせ
+| ローカルカタログ | `./scripts/populate-local-skills.sh` | `public/skills/index.json` とファイルチェックサムの人口 お問い合わせ
+| ローカルフィード | `./scripts/populate-local-feed.sh --days 120` | ローカルアドバイザリーフィードのコピーを更新しました。 お問い合わせ
+| wiki llms のエクスポートを生成する | `npm run gen:wiki-llms` | `public/wiki/llms.txt` とページごとのエクスポートを更新します。 お問い合わせ
+| ローカルゲートを走らせて下さい | `./scripts/prepare-to-push.sh` | CIのようなパス/fail信号。 お問い合わせ
+| 開発UIスタート | `npm run dev` | ローカルViteエンドポイントでのブラウザプレビュー お問い合わせ
+
+ツイート リリースワークフローの詳細
+- PR/tag パスでは、バージョン バンプと docs のパシティが強化されます。
+- スキルパッケージには、SBOM-declaredファイルと完全性マニフェストが含まれています。
+- `checksums.json`は署名され、ワークフローの実行ですぐに検証されます。
+- 設定されたとき、GitHubリリースの成功後、オプションのpublish-to-ClawHubジョブが実行されます。
+- 同じ主要なライン内の古いリリースは、自動化によって監督/削除することができます。
+
+## 諮問ワークフローの詳細
+- NVDワークフローは、以前のフィード`updated`タイムスタンプから増分ウィンドウを決定します。
+- フェーズマップCVEメトリックを重症/タイプに変換し、影響を受けたターゲットを正規化します。
+- コミュニティアドバイザリーワークフローは、問題メタデータから決定的なID(`CLAW-YYYY-NNNN`)を作成します。
+- アドバイザリーワークフローは、スキルフィードコピーと署名者を更新します。
+
+## サンプルスニペット
+```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]
+```
+
+##運用リスク
+- ワークフロー権限と秘密のスコープの不正設定は、署名/公開をブロックできます。
+- NVD/API の一時的な失敗はアドバイザリーの新鮮さを遅らせるかもしれません。
+- Invalidタグのネーミングやバージョンのミスマッチのハレットリリース自動化。
+- オペレータ機械が予想されるバイナリ(`jq`、`openssl`、`clawhub`)を欠いているかどうか、ローカルスクリプトとCIは掘り下げることができます。
+
+## ソース参照
+- スクリプト/リリース-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/pages-verify.yml
+- .github/workflows/wiki-sync.yml
+- .github/workflows/codeql.yml
+- .github/workflows/scorecard.yml
+- .github/actions/sign-and-verify/action.yml
diff --git a/wiki/ko/GENERATION.md b/wiki/ko/GENERATION.md
new file mode 100644
index 0000000..fd53a05
--- /dev/null
+++ b/wiki/ko/GENERATION.md
@@ -0,0 +1,42 @@
+
+
+# Wiki Generation Metadata
+
+- Commit hash: `c3983a100581a9f27eb8cc3b5baa4f585e6c45e4`
+- Branch name: `codex/clawsec-scanner-0.0.2-dast-harness`
+- Generation timestamp (local): `2026-03-10T19:06:29+0200`
+- Generation mode: `update`
+- Output language: `English`
+- Assets copied into `wiki/assets/`:
+ - `overview_img_01_prompt-security-logo.png` (from `img/Black+Color.png`)
+ - `overview_img_02_clawsec-mascot.png` (from `public/img/mascot.png`)
+ - `architecture_img_01_prompt-line.svg` (from `public/img/prompt_line.svg`)
+
+## Notes
+- Migrated root documentation pages from `docs/` into dedicated `wiki/` operation pages.
+- Updated index and cross-links to use `wiki/` as the documentation source of truth.
+- Added a dedicated module page for `clawsec-scanner` and linked it from `wiki/INDEX.md`.
+- Future updates should preserve existing headings and append `Update Notes` sections when making deltas.
+- 2026-04-15: Expanded `wiki/modules/hermes-attestation-guardian.md` into full narrative claim breakdowns (people-speak + wiring + verification + scenario) and moved draft-plan context into `wiki/modules/hermes-attestation-guardian-draft-history.md`.
+- 2026-04-26: Split Picoclaw self-pen-testing into dedicated `wiki/modules/picoclaw-self-pen-testing.md`, and updated `wiki/modules/picoclaw-security-guardian.md` to cover advisory/drift/supply-chain scope only.
+- 2026-04-25: Added DeepWiki-friendly `wiki/modules/picoclaw-security-guardian.md` with support-matrix claims, threat model, default safety posture, frontend/advisory-board wiring, verification commands, and source references. Regenerated `public/wiki/**/llms.txt` exports with `npm run gen:wiki-llms`.
+
+## Source References
+- README.md
+- package.json
+- AGENTS.md
+- wiki/overview.md
+- wiki/architecture.md
+- wiki/modules/clawsec-scanner.md
+- wiki/modules/picoclaw-security-guardian.md
+- wiki/modules/picoclaw-self-pen-testing.md
+- wiki/dependencies.md
+- wiki/data-flow.md
+- wiki/glossary.md
+- wiki/security-signing-runbook.md
+- wiki/migration-signed-feed.md
+- wiki/platform-verification.md
+- wiki/remediation-plan.md
diff --git a/wiki/ko/INDEX.md b/wiki/ko/INDEX.md
new file mode 100644
index 0000000..9e2b9d5
--- /dev/null
+++ b/wiki/ko/INDEX.md
@@ -0,0 +1,35 @@
+# 위키 인덱스 (한국어)
+
+## 요약
+- 이 문서는 ClawSec 위키의 한국어 진입점입니다.
+- 영어 문서(`wiki/*.md`)가 정본(source of truth)이며, 한국어는 단계적으로 확장됩니다.
+
+## 시작하기
+- [Overview (KO)](overview.md)
+- [Overview (EN)](../overview.md)
+- [Architecture (EN)](../architecture.md)
+
+## 가이드
+- [Localization Workflow (KO)](localization.md)
+- [Localization Workflow (EN)](../localization.md)
+- [Dependencies](../dependencies.md)
+- [Data Flow](../data-flow.md)
+- [Configuration (KO)](configuration.md)
+- [Testing](../testing.md)
+- [Workflow](../workflow.md)
+- [Security (KO)](security.md)
+
+## 모듈
+- [Frontend Web App](../modules/frontend-web.md)
+- [ClawSec Suite Core](../modules/clawsec-suite.md)
+- [NanoClaw Integration](../modules/nanoclaw-integration.md)
+- [Hermes Attestation Guardian](../modules/hermes-attestation-guardian.md)
+- [Picoclaw Security Guardian](../modules/picoclaw-security-guardian.md)
+
+## 번역 노트
+- 2026-04-27: 한국어 위키 초기 스캐폴드 추가 (`wiki/ko/INDEX.md`, `wiki/ko/overview.md`).
+
+## 소스 참조
+- `wiki/INDEX.md`
+- `wiki/overview.md`
+- `wiki/localization.md`
diff --git a/wiki/ko/architecture.md b/wiki/ko/architecture.md
new file mode 100644
index 0000000..4f3608a
--- /dev/null
+++ b/wiki/ko/architecture.md
@@ -0,0 +1,136 @@
+
+
+# 건축
+
+## 체계 콘텍스트
+- - - 이 페이지는 `Start Here` 섹션에서 나타납니다.
+- ClawSec은 업스트림 인텔리전스 소스 (NVD + 커뮤니티 문제), GitHub 자동화 및 런타임 에이전트 환경 사이에 앉아 있습니다.
+- - - Repository는 static 사이트 콘텐츠를 게시하고 사용하기 전에 런타임 기술 검증을 서명했습니다.
+- 외부 배우 그룹:
+- GitHub Actions runners는 CI, 릴리스 및 피드 워크플로우를 실행합니다.
+- OpenClaw/NanoClaw 에이전트 consuming 기술, 고문 및 검증 스크립트.
+- Repository maintainers는 자문 문제 및 merging release/tag 변화를 찬성합니다.
+
+## 부품
+| 부품 | 위치 | 책임 |
+인포메이션
+| 웹 UI | `App.tsx`, `pages/`, `components/` | 기술 카탈로그 및 자문 세부 경험 렌더링. ·
+| 자문 사료 코어 | `advisories/feed.json*`, `skills/clawsec-suite/.../feed.mjs` | 매장, 검증 및 파스 자문 ·
+| 스킬패키지 | `skills/*/` | SBOM 메타데이터를 이용한 분산형 보안 기능 ·
+| Local Automation Scripts | `scripts/*.sh` | 현지 미러, 사전 푸시 체크 및 수동 릴리즈 헬퍼 구축 ·
+| CI/CD 워크플로 | `.github/workflows/*.yml` | Linting, tests, NVD polling, release Packaging, 페이지 배포. ·
+| Python Utility Layer | `utils/*.py` | 기술 메타데이터 검증 및 체크섬 생성 ·
+
+# # # # # # # # # # # 키 흐름
+- 기술 카탈로그 흐름:
+1. Release/tag 워크플로우 게시 기술 자산.
+2. 배포 워크플로우는 릴리스 자산을 발견하고 `public/skills/index.json`를 구축합니다.
+3. `/skills` 페이지에 대한 UI fetches `public/skills/index.json` 및 기술 문서.
+- 자문 피드 흐름:
+1. `poll-nvd-cves.yml` 및 `community-advisory.yml` 업데이트 `advisories/feed.json`.
+2. 급식은 서명하고 대중적인 경로에 미러링됩니다.
+3. Runtime Hooks/scripts는 국부적으로 서명한 사본에 먼 급식 및 fallback를 적재합니다.
+- Guarded 설치 흐름:
+1. 설치자 요청 대상 기술 + 버전.
+2. 자문 성냥꾼은 specifiers와 severity/risk hints를 검사합니다.
+3. 출구 부호 42는 고문 경기 때 두번째 확인을 강제합니다.
+
+## 다이어그램
+```mermaid
+flowchart TD
+ A["NVD + Community Inputs"] --> B["Feed Workflows\n(poll/community)"]
+ B --> C["advisories/feed.json + signatures"]
+ C --> D["Deploy Workflow Mirrors to public/"]
+ D --> E["React UI (catalog/feed pages)"]
+ C --> F["clawsec-suite hook + installers"]
+ F --> G["Agent advisory alerts / gated install"]
+```
+
+
+
+## 인터페이스 및 계약
+| 인터페이스 | 계약서 | 검증 |
+인포메이션
+| 스킬 메타데이터 | `skills/*/skill.json` | 파이썬 유틸리티 + CI 버전 비교 검사로 검증 ·
+| 자문 피드 | JSON + Ed25519 detached 시그니처 | `feed.mjs` 및 NanoClaw 시그니처 유틸리티 인증 ·
+| 체크섬 | `checksums.json`(옵션 `.sig`) | 페이로드를 신뢰하기 전에 Parsed 및 해시 일치합니다. ·
+· 후크 이벤트 인터페이스 | `HookEvent` (`type`, `action`, `messages`) | 런타임 핸들러만 선택된 이벤트명. ·
+| 워크 플로우 릴리즈 naming | 태그 패턴 `-vX.Y.Z` | 출시/ 배포 워크플로우에서 기술 발견. ·
+
+# # # # # # # # # # # 핵심 모수
+| 매개 변수 | 기본 | 효과 |
+인포메이션
+| `CLAWSEC_FEED_URL` | `https://clawsec.prompt.security/advisories/feed.json` | 스위트 스크립트/훅용 원격 자문 소스 ·
+| `CLAWSEC_ALLOW_UNSIGNED_FEED` | `0` | 임시 불신뢰도 무상 호환성이 있습니다. ·
+| `CLAWSEC_VERIFY_CHECKSUM_MANIFEST` | `1` | 자주 묻는 질문(FAQ) ·
+| `CLAWSEC_HOOK_INTERVAL_SECONDS` | `300` | 고문 후크 스캔 스로틀링 창. ·
+| `CLAWSEC_SKILLS_INDEX_TIMEOUT_MS` | `5000` | 카탈로그 검색에 대한 원격 기술 색인 fetch timeout ·
+| `PROMPTSEC_GIT_PULL` | `0` | watchdog 감사의 전 선택 자동 요금 ·
+
+## 오류 처리 및 신뢰성
+- Feed fetching은 잘못된 서명과 변형 된 표시를 위해 실패합니다.
+- 원격 fetch 실패는 완전히 로컬 서명 피드로 돌아갑니다.
+- Hook state는 atomic 파일이 지원되는 엄격한 모드로 작성합니다.
+- UI 페이지는 JSON으로 제공되는 HTML fallback을 감지하고 손상된 데이터를 렌더링합니다.
+- 워크 플로우 단계는 분할 키 드립을 방지하기 위해 키 지문 일관성을 적용합니다.
+
+## 예제 Snippets
+```tsx
+// Route topology in the web app
+
+
+```
+
+```ts
+// Guarded feed loading contract in advisory hook
+const remoteFeed = await loadRemoteFeed(feedUrl, {
+ signatureUrl: feedSignatureUrl,
+ checksumsUrl: feedChecksumsUrl,
+ checksumsSignatureUrl: feedChecksumsSignatureUrl,
+ publicKeyPem,
+ checksumsPublicKeyPem: publicKeyPem,
+ allowUnsigned,
+ verifyChecksumManifest,
+});
+```
+
+## 런타임 및 배포
+| 런타임 표면 | 런타임 모델 | 출력 |
+인포메이션
+| Vite 앱(`npm run dev`) | 로컬 프론트엔드 서버 | 피드/스킬에 대한 인터랙티브 웹 앱. ·
+| GitHub CI | 멀티OS 매트릭스 + 전용 구인 | Lint/type/build/security 및 테스트 신뢰 ·
+· 기술 릴리스 워크플로우 | 태그 구동 출판 + PR 건식 체크 | 릴리스 자산, 서명된 체크섬, 옵션 ClawHub 출판. ·
+· 페이지 배치 워크플로우 | CI/Release Success | 정적 사이트 + 미러링 자문/출판. ·
+| 런타임 후크 | OpenClaw 이벤트 후크 / NanoClaw IPC | 자문 경고, 편집 결정, 무결성 검사. ·
+
+## 확장 노트
+- NVD polling의 키워드 세트와 자문 볼륨 스케일; dedupe 및 포스트 필터링 제어 소음.
+- Deploy 워크플로우 프로세스 릴리스 목록 및 색인 출력의 최신 기술 버전을 유지.
+- 기술 폴더에 의해 모듈 경계는 frontend 구조를 변경하지 않고 새로운 보안 기능을 추가 할 수 있습니다.
+- 시그니처 검증 경로는 페이로드 크기 (feed/manifests)가 작기 때문에 경량 유지.
+
+## 소스 참조
+- 앱.tsx
+- 페이지/SkillsCatalog.tsx
+- 페이지/FeedSetup.tsx
+- 페이지/AdvisoryDetail.tsx
+- 페이지/WikiBrowser.tsx
+- 기술/하프스위트/훅/하프스위트 자문/handler.ts
+- 기술/하프스위트/훅/하프스위트 자문/lib/feed.mjs
+- 기술/클래스/scripts/guarded_skill_install.mjs
+- 기술/하프스위트/script/discover_skill_catalog.mjs
+- 기술/클로슈-nanoclaw/lib/advisories.ts
+- 기술/클로슈-nanoclaw/lib/signatures.ts
+- .github/workflows/poll-nvd-cves.yml의 경우
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml의 경우
+- .github/workflows/skill-release.yml의 경우
diff --git a/wiki/ko/configuration.md b/wiki/ko/configuration.md
new file mode 100644
index 0000000..8169a05
--- /dev/null
+++ b/wiki/ko/configuration.md
@@ -0,0 +1,88 @@
+# Configuration (한국어)
+
+## 범위
+- Configuration은 프런트엔드 빌드 설정, 런타임 피드 경로, 워크플로우 트리거, 스킬 메타데이터 계약을 포함합니다.
+- 런타임에 민감한 대부분의 제어는 `CLAWSEC_` 또는 `OPENCLAW_` 접두사를 가진 환경 변수를 사용합니다.
+- 경로 정규화는 보안 민감 영역이며, 해석되지 않은 home-token literal을 의도적으로 거부합니다.
+
+## 핵심 런타임 변수
+| 변하기 쉬운 | 기본 | 이용 |
+인포메이션
+| `CLAWSEC_FEED_URL` | Hosted advisory URL | Suite hook 및 guarded installer의 피드 로딩 |
+| `CLAWSEC_FEED_SIG_URL` | `.sig` | Detached signature 소스 |
+| `CLAWSEC_FEED_CHECKSUMS_URL` | `checksums.json` near feed URL | 선택적 checksum-manifest 소스 |
+| `CLAWSEC_FEED_PUBLIC_KEY` | Suite-local PEM file | 피드 서명 검증 |
+| `CLAWSEC_ALLOW_UNSIGNED_FEED` | `0` | 임시 마이그레이션 bypass 플래그 |
+| `CLAWSEC_VERIFY_CHECKSUM_MANIFEST` | `1` | checksum-manifest 검증 활성화 |
+| `CLAWSEC_HOOK_INTERVAL_SECONDS` | `300` | advisory hook 스캔 스로틀 |
+
+## 경로 해석 규칙
+| 규칙 | 행동 | 시행 위치 |
+인포메이션
+| `~` expansion | 감지된 홈 디렉터리로 해석 | suite/watchdog 스크립트의 공용 path 유틸리티 |
+| `$HOME` / `${HOME}` expansion | 이스케이프되지 않은 경우 해석 | 동일 유틸리티 |
+| Windows home tokens | `%USERPROFILE%`, `$env:USERPROFILE` 정규화 | 동일 유틸리티 |
+| Escaped tokens (`\$HOME`) | 명시적 에러와 함께 거부 | 실수로 literal 디렉터리 생성 방지 |
+| Invalid explicit path | 경고 후 기본 경로로 fallback 가능 | `resolveConfiguredPath` helpers |
+
+## 프런트엔드 및 빌드 설정
+- `vite.config.ts`는 포트(`3000`), 호스트(`0.0.0.0`), path alias(`@`)를 정의합니다.
+- `index.html`은 Tailwind runtime config, 커스텀 폰트, 기본 색상 토큰을 제공합니다.
+- `tsconfig.json`은 bundler 모듈 해석, `noEmit`, JSX runtime 설정을 사용합니다.
+- `eslint.config.js`는 TS/React/hooks 및 스크립트 전용 lint 규칙을 적용합니다.
+
+## 스킬 메타데이터 설정
+| 필드 그룹 | 위치 | 기능 |
+인포메이션
+| Core skill identity | `skills/*/skill.json` | 이름/버전/작성자/라이선스/설명 메타데이터 |
+| SBOM file list | `skill.json -> sbom.files` | 릴리스 필수 아티팩트 선언 |
+| Platform metadata | `openclaw` or `nanoclaw` blocks | CLI 요구사항, 트리거, 플랫폼 capability 힌트 |
+| Suite catalog metadata | `skills/clawsec-suite/skill.json -> catalog` | suite 멤버의 통합/기본/동의 동작 |
+
+## 워크플로우 설정
+- 스케줄 설정은 워크플로우의 `cron` 항목(`poll-nvd-cves`, `codeql`, `scorecard`)에 존재합니다.
+- 릴리스 워크플로우는 `-v` 태그 패턴을 기대합니다.
+- 배포 워크플로우는 성공한 CI/release `workflow_run` 이벤트와 수동 실행으로 트리거됩니다.
+- composite signing action은 private key 입력이 필요하며, 서명 직후 검증을 수행합니다.
+
+## 예시 스니펫
+```bash
+# run guarded install with explicit local signed feed paths
+CLAWSEC_LOCAL_FEED="$HOME/.openclaw/skills/clawsec-suite/advisories/feed.json" \
+CLAWSEC_LOCAL_FEED_SIG="$HOME/.openclaw/skills/clawsec-suite/advisories/feed.json.sig" \
+CLAWSEC_FEED_PUBLIC_KEY="$HOME/.openclaw/skills/clawsec-suite/advisories/feed-signing-public.pem" \
+node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill clawtributor --dry-run
+```
+
+```json
+{
+ "name": "example-skill",
+ "version": "1.2.3",
+ "sbom": {
+ "files": [
+ { "path": "SKILL.md", "required": true, "description": "Install docs" }
+ ]
+ }
+}
+```
+
+## 운영 노트
+- signing key는 리포지토리에 두지 말고 GitHub Secrets로만 주입하세요.
+- 로컬 환경 변수 override에는 절대 경로나 이스케이프되지 않은 home 표현식을 권장합니다.
+- unsigned feed 모드는 정상 운영이 아닌 임시 마이그레이션 지원으로 취급하세요.
+- `SKILL.md` URL을 수정하면 broken artifact reference 방지를 위해 release-link validation을 재실행하세요.
+
+## 소스 참조
+- `vite.config.ts`
+- `index.html`
+- `tsconfig.json`
+- `eslint.config.js`
+- `skills/clawsec-suite/skill.json`
+- `skills/clawsec-nanoclaw/skill.json`
+- `skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/utils.mjs`
+- `skills/openclaw-audit-watchdog/scripts/load_suppression_config.mjs`
+- `skills/clawsec-suite/scripts/guarded_skill_install.mjs`
+- `scripts/validate-release-links.sh`
+- `.github/workflows/poll-nvd-cves.yml`
+- `.github/workflows/skill-release.yml`
+- `.github/actions/sign-and-verify/action.yml`
diff --git a/wiki/ko/data-flow.md b/wiki/ko/data-flow.md
new file mode 100644
index 0000000..f37deac
--- /dev/null
+++ b/wiki/ko/data-flow.md
@@ -0,0 +1,103 @@
+
+
+₢ 킹 데이터 흐름
+
+## 1 차적인 교류
+- `Advisory ingestion`: NVD/community 입력은 정상화된 자문 급식으로, 서명된, 그 후에 클라이언트를 위해 미러링됩니다.
+- `Skill catalog publication` : 릴리스 자산은 `public/skills/index.json` 플러스 per-skill docs/checksums로 발견되고 변환됩니다.
+- `Runtime enforcement` : 스위트 및 나노 클로 소비자 부하 자문 데이터, 기술에 대한 일치, 경고 또는 확인 게이트를 방출.
+- - - 이 페이지는 `Guides` 섹션에서 나타납니다.
+
+## 단계별
+1. 명세 피드 프로듀서 워크 플로우 / 기술 fetches 소스 데이터 (`NVD API` 또는 문제 페이로드).
+2. 명세 JSON 변형 논리는 severity/type/affected 필드를 정상화하고 고문 ID에 의해 해독합니다.
+3. 명세 시그니처/체크섬 단계는 시그니처 및 체크섬을 생성합니다.
+4. 명세 배포 워크플로우 미러는 `public/` 및 `public/releases/latest/download/` 아래 artifacts에 서명했습니다.
+5. 명세 UI 소비자는 JSON 모양/내용을 유효하게 합니다; 런타임 소비자는 추가적으로 피드 데이터를 신뢰하기 전에 서명/체크를 확인합니다.
+6. 명세 Matchers는 기술 이름/버전에 `affected` specifiers를 비교하고 경고 또는 시행 확인을 방출합니다.
+
+## 입력 및 출력
+입력/출력은 아래에 테이블에서 요약됩니다.
+
+| 유형 | 이름 | 위치 | 묘사 |
+| | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
+| 입력 | CVE 페이로드 | `services.nvd.nist.gov/rest/json/cves/2.0` | ClawSec 키워드로 필터링하는 소스 취약점. ·
+| 입력 | 커뮤니티 자문 문제 | `.github/workflows/community-advisory.yml` 이벤트 페이로드 | 옹호자 등록 ·
+| 입력 | 기술 릴리스 자산 | GitHub Releases API + Asset | 웹 카탈로그 및 미러 다운로드를 구축하는 데 사용됩니다. ·
+| 입력 | Local config/env | `OPENCLAW_AUDIT_CONFIG`, `CLAWSEC_*` vars | 제어 피드 경로, 억제 및 검증 행동. ·
+| 출력 | 자문 피드 | `advisories/feed.json` | Canonical repository Feed. ·
+| 출력 | 자문 시그니처 | `advisories/feed.json.sig` | 피드 인증 시그니처 ·
+| 산출 | 기술 카탈로그 인덱스 | `public/skills/index.json` | `/skills` 페이지에 사용된 런타임 웹 카탈로그. ·
+| 출력 | 릴리즈 체크섬/신문 | `release-assets/checksums.json(.sig)` | 출시 소비자의 정수입니다. ·
+| 출력 | 후크 상태 | `~/.openclaw/clawsec-suite-feed-state.json` | 타이밍 및 알림을 추적합니다. ·
+
+# # # # # # # # # # # 데이터 구조
+| 구조 | 핵심 분야 | 용도 |
+인포메이션
+| 자문 사료 기록 | `id`, `severity`, `type`, `affected[]`, `published` | UI 및 설치자가 사용하는 위험 데이터 단위. ·
+| 기술 메타데이터 레코드 | `id`, `name`, `version`, `emoji`, `tag` | 웹 브라우징 및 설치 명령의 카탈로그 행. ·
+| 체크섬 | `schema_version`, `algorithm`, `files` | 예상되는 다이제스트 파일 이름. ·
+| 자문 상태 | `known_advisories`, `last_hook_scan`, `notified_matches` | 반복 경고 및 흉상 검사를 방지합니다. ·
+| Suppression config | `enabledFor[]`, `suppressions[]` | `checkId` + `skill`의 뚜렷한 건너뛰기 목록. ·
+
+## 다이어그램
+```mermaid
+flowchart LR
+ A["NVD + Issue Inputs"] --> B["Transform + Deduplicate"]
+ B --> C["advisories/feed.json"]
+ C --> D["Sign + checksums"]
+ D --> E["public/advisories + releases/latest"]
+ E --> F["Web UI fetch"]
+ E --> G["Suite/NanoClaw verification"]
+ G --> H["Match skills + emit alerts/gates"]
+```
+
+## 국가 및 저장
+| Store | Path/Scope | 글쓰기 경로 |
+인포메이션
+| Canonical advisories | `advisories/` | NVD + 커뮤니티 워크플로우 및 로컬 포뮬러 스크립트. ·
+· 임베디드 자문부 | `skills/clawsec-feed/advisories/` 및 `skills/clawsec-suite/advisories/` | 동기화/패킹 프로세스 및 릴리스 워크플로우. ·
+| 공개 미러 | `public/advisories/`, `public/releases/` | 배포 워크플로우. ·
+| 런타임 상태 | `~/.openclaw/clawsec-suite-feed-state.json` | 자문 훅 상태 지속 ·
+| 나노 클로 캐시 | `/workspace/project/data/clawsec-advisory-cache.json` | 호스트 사이드 자문 캐시 관리자. ·
+| Integrity state | `/workspace/project/data/soul-guardian/`(NanoClaw) | Integrity 모니터 기본/오디오 저장. ·
+
+## 예제 Snippets
+```bash
+# Local feed flow (NVD fetch -> transform -> sync)
+./scripts/populate-local-feed.sh --days 120
+jq '.updated, (.advisories | length)' advisories/feed.json
+```
+
+```bash
+# Runtime guarded install uses signed feed paths
+CLAWSEC_LOCAL_FEED=~/.openclaw/skills/clawsec-suite/advisories/feed.json \
+CLAWSEC_FEED_PUBLIC_KEY=~/.openclaw/skills/clawsec-suite/advisories/feed-signing-public.pem \
+node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+```
+
+## 실패 모드
+- NVD 비율 한계 (`403/429`)는 급식을 상쾌하게 연기하고 retries/backoff를 요구합니다.
+- 미싱 또는 잘못된 분리 된 서명은 실패 닫힌 모드에서 피드 거부를 유발합니다.
+- JSON endpoints에 대한 HTML fallback 응답은 명시적으로 필터링하지 않는 한 false 긍정을 생성할 수 있습니다.
+- Path-token misconfiguration (`\$HOME`)는 로컬 fallback 경로 해상도를 깰 수 있습니다.
+- 워크플로우에서 매끄러운 공공 키 지문은 어려운 CI 실패를 유발합니다.
+
+## 소스 참조
+- 고문/feed.json
+- 고문/feed.json.sig
+- 스크립트/populate-local-feed.sh
+- 스크립트/populate-local-skills.sh
+- .github/workflows/poll-nvd-cves.yml의 경우
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml의 경우
+- .github/workflows/skill-release.yml의 경우
+- 기술/하프스위트/훅/하프스위트 자문/lib/feed.mjs
+- 기술/하프스위트/훅/하프스위트 자문/lib/state.ts
+- 기술/하프스위트/훅/하프스위트 자문/lib/matching.ts
+- 기술/클래스/scripts/guarded_skill_install.mjs
+- 기술/클로슈-nanoclaw/lib/advisories.ts
+- 기술/하프-nanoclaw/host-services/advisory-cache.ts
diff --git a/wiki/ko/dependencies.md b/wiki/ko/dependencies.md
new file mode 100644
index 0000000..eb54edf
--- /dev/null
+++ b/wiki/ko/dependencies.md
@@ -0,0 +1,106 @@
+
+
+# 통화
+
+## 빌드 및 실행 시간
+| 층 | 차종별 | 왜 존재 |
+인포메이션
+| 프론트엔드 런타임 | `react`, `react-dom`, `react-router-dom`, `lucide-react` | UI 렌더링, 라우팅, 상징. ·
+인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 인포메이션 ·
+| 툴링 구축 | `vite`, `@vitejs/plugin-react`, `typescript` | 빠른 TS/TSX 번들링 및 생산 빌드. ·
+| Python 유틸리티 | stdlib + `ruff`/`bandit` 정책 `pyproject.toml` | 유효성 검사 및 정적 검사를 실행합니다. ·
+· 쉘 오토메이션 | `bash`, `jq`, `curl`, `openssl`, `sha256sum`/`shasum` | 펌핑, 서명, 체크섬 생성, 릴리즈 체크. ·
+
+## Dependency 세부사항
+| 포장 | 버전 제약 | 범위 |
+인포메이션
+| `react` / `react-dom` | `^19.2.4` | 프론트엔드런타임 |
+| `react-router-dom` | `^7.13.1` | 프론트 라우팅 |
+| `lucide-react` | `^0.575.0` | UI 아이콘 세트 |
+| `vite` | `^7.3.1` | 개발자 서버 + 빌드 |
+| `typescript` | `~5.8.2` | 유형 검사 |
+| `eslint` | `^9.39.2` | JS/TS 라이팅 |
+| `@typescript-eslint/*` | `^8.55.0` / `^8.56.0` | TS lint 파서/루즈 |
+| `fast-check` | `^4.5.3` | 속성/후자 스타일 테스트 |
+
+| Override | Pinned Version | 직업 |
+인포메이션
+| `ajv` | `6.14.0` | 보안 및 호환성 안정화 ·
+| `balanced-match` | `4.0.3` | 교통 취약점 제어 ·
+| `brace-expansion` | `5.0.2` | 변속성 경화 ·
+| `minimatch` | `10.2.1` | 세터미니즘 의존성 행동 ·
+
+## 외부 서비스
+| 서비스 | 이용 | 기능 |
+인포메이션
+| NVD API (`services.nvd.nist.gov`) | `poll-nvd-cves` 워크플로우 + 로컬 피드 스크립트 | 키워드/날짜 창에서 CVE를 풀 수 있습니다. ·
+| GitHub API | Deploy/release 워크플로우 | 릴리스, 다운로드 자산, 게시 출력. ·
+| GitHub Pages | 배포 워크플로우 | 정적 사이트와 미러링 아트ifacts. ·
+| ClawHub CLI/registry | 스크립트 설치 + 옵션 게시 작업 | 설치 및 출판 기술. ·
+| 옵션 로컬 SMTP/sendmail | `openclaw-audit-watchdog` 스크립트 | 이메일에 의한 감사보고서 전달 ·
+
+## 개발 도구
+인포메이션 | 인포메이션 | 커버리지 |
+인포메이션
+| ESLint | `npx eslint . --ext .ts,.tsx,.js,.jsx,.mjs --max-warnings 0` | 프론트엔드・스크립팅 ·
+| TypeScript | `npx tsc --noEmit` | 실시간 TS 계약 확인 ·
+| Ruff | `ruff check utils/` | 파이썬 스타일과 버그 패턴 체크. ·
+| Bandit | `bandit -r utils/ -ll` | Python 보안 검사 ·
+| Trivy | 워크플로우+옵션 로컬런 | FS/config 취약점 검사 ·
+| 깁스 | `scripts/prepare-to-push.sh` 옵션 로컬 실행 | 푸시 하기 전에 비밀 누출 검출. ·
+
+## 예제 Snippets
+```json
+{
+ "scripts": {
+ "dev": "vite",
+ "build": "vite build",
+ "preview": "vite preview"
+ },
+ "dependencies": {
+ "react": "^19.2.4",
+ "react-router-dom": "^7.13.1"
+ }
+}
+```
+
+```toml
+[tool.ruff]
+target-version = "py310"
+line-length = 120
+
+[tool.bandit]
+exclude_dirs = ["__pycache__", ".venv"]
+skips = ["B101"]
+```
+
+## 호환성 주
+- `date` 및 `stat` 사용의 Linux 차이를 위한 로컬 스크립트 계정.
+- 일부 워크플로우/script는 OpenSSL 기능이 Ed25519 및 `pkeyutl -rawin`와 함께 사용됩니다.
+- Windows 지원은 노드 기반 툴링에 가장 강합니다. POSIX 쉘 경로는 WSL/Git Bash가 필요할 수 있습니다.
+- 급식 소비자는 마이그레이션 단계에 대한 호환성 우회를 포함, 그러나 서명된 형태는 예정된 꾸준한 국가입니다.
+
+## 버전 노트
+- 기술 출시 태그는 `-v`를 따르고 CI/deploy 자동화에 의해 파싱됩니다.
+- PR 검증은 `skill.json`와 `SKILL.md` frontmatter 사이의 버전 패리티를 실행합니다.
+- - - 공공 기술 지수는 UI 디스플레이에 대한 기술 당 최신 발견 된 버전을 유지합니다.
+- 서명된 artifact는 (`checksums.json`) 방출 당 버전되고 파일 해시와 URL을 포함합니다.
+
+## 소스 참조
+- 패키지.json
+- 패키지-lock.json
+프로젝트
+- eslint.config.js에
+- tsconfig.json의
+- 스크립트/prepare-to-push.sh
+- 스크립트/populate-local-feed.sh
+- 스크립트/populate-local-skills.sh
+- .github/workflows/ci.yml의 경우
+- .github/workflows/codeql.yml의
+- .github/workflows/scorecard.yml의 경우
+- .github/workflows/poll-nvd-cves.yml의 경우
+- .github/workflows/deploy-pages.yml의 경우
+- .github/workflows/skill-release.yml의 경우
diff --git a/wiki/ko/exploitability-scoring.md b/wiki/ko/exploitability-scoring.md
new file mode 100644
index 0000000..b82e8b9
--- /dev/null
+++ b/wiki/ko/exploitability-scoring.md
@@ -0,0 +1,425 @@
+
+
+# Exploitability 부식 방법론
+
+## 개요
+
+ClawSec의 악용성 득점 체계는 AI 대리인 배치 (OpenClaw/NanoClaw)를 위해 특별히 디자인된 상황에 인식 취약성 평가를 제공합니다. 모든 환경을 똑같게 대우하는 일반적인 CVSS 점수와는 달리, 우리의 득점은 AI 대리인의 유일한 공격 표면 및 사용법 본을 고려하여 경고 피로를 감소시키고 행동 가능한 위협을 우선시합니다.
+
+## 득점 수준
+
+| 레벨 | 관능 | 의미 |
+|---|---||
+| `high` | 긴요한/고 | 일반적인 에이전트 배포, 즉각적인 관심 필요 |
+| `medium` | 중형 | 구성에 따라 활용 가능 | 보증 조사 |
+| `low` | 저소음 | 에이전트 컨텍스트, 저소득층 |
+| `unknown` | 알 수없는 | 악용성을 평가하는 충분한 자료 |
+
+## 득점 요인
+
+# # # # # # # # # # # 1. CVSS 기본 점수 (기본값)
+
+분석은 CVSS 기본 점수를 기초로 시작합니다.
+
+- **CVSS ≥ 9.0**: 긴 수명 → 초기 점수 `high`
+- **CVSS 7.0-8.9**: 높은 심각성 → 초기 점수 `high`
+- **CVSS 4.0-6.9**: 중간 심각성 → 초기 점수 `medium`
+- **CVSS 1.0-3.9**: 낮은 severity → 초기 점수 `low`
+- ** CVSS**: → 초기 점수 사이트맵
+
+# # # # # # # # # # # 2. 공격 벡터 분석 (CVSS 미터)
+
+분석가는 CVSS v2, v3.0 및 v3.1 벡터를 구문합니다.
+
+### 네트워크 접근성
+- **AV:N** (네트워크): 네트워크에 원격으로 악용
+- **AV:A** (Adjacent): 로컬 네트워크 액세스를 요구합니다.
+- **AV:L** (Local): 로컬 시스템 액세스 필요
+- **AV:P** (Physical): 물리적 접근
+
+** 에이전트에 중요 **: Network-accessible 취약점은 일반적으로 네트워크 서비스로 실행되거나 외부 API 호출을 할 수 있기 때문입니다.
+
+#### 인증 요건
+- **PR:N / Au:NONE**: 인증 필요 없음 → 점수 상승
+- **PR:L / Au:SINGLE**: 낮은 특전
+- **PR:H / Au:MULTIPLE**: 요구되는 높은 특권 → 득점
+
+** 에이전트에 중요 **: Unauthenticated 악용은 공개적으로 노출되는 대리인 APIs를 위해 중요합니다.
+
+#### 사용자 상호 작용
+- **UI:N**: 사용자 상호 작용이 필요 없음 → 점수 상승
+- **UI:R**: 사용자의 상호 작용을 요구 → 점수를 감소
+
+** 에이전트에 중요 **: 에이전트는 종종 자율적으로 작동하므로 사용자 상호 작용이 덜 중요합니다.
+
+#### 공격 Complexity
+- **AC:L**: 낮은 복잡성 → 점수 상승
+- **AC:M / AC:H**: 중간/고단성 → 중립 또는 점수를 감소
+
+** 에이전트에 중요 **: Low-complexity 악용은 자동화되고 대량 공격에 사용됩니다.
+
+# # # # # # # # # # # 3. 취약점 유형 (Deployment Context)
+
+ClawSec은 취약점 유형이 AI 에이전트 배포에 영향을 미치는 방법에 따라 점수를 조정합니다.
+
+### 대리인 Context에 있는 높 토크 유형
+
+** 원격 코드 실행 (RCE)* * 이름
+```
+Score: Always HIGH
+Rationale: RCE is critical in agent deployments
+```
+AI Agent는 arbitrary 코드를 함수의 일부로 실행합니다. RCE 취약점은 공격자가 납치 에이전트 실행 흐름, exfiltrate credentials, 또는 다른 시스템에 피벗을 수 있습니다.
+
+** 서버 측 요청 위조 (SSRF) * * 이름
+```
+Score: Elevated to HIGH if CVSS ≥ 6.0
+Rationale: SSRF affects agents making external requests
+```
+에이전트는 외부 API, 내부 서비스에 액세스, 그리고 원격 리소스를 호출. SSRF는 공격자를 허용합니다:
+- 내부 클라우드 메타데이터 서비스 접근 (AWS IMDSv1, GCP 메타데이터)
+- 내부 네트워크에 Pivot
+- DNS 터널링을 통한 Exfiltrate 데이터
+
+**Path Traversal / 디렉토리 트레이널 * * 이름
+```
+Score: Elevated to HIGH if CVSS ≥ 6.0
+Rationale: Path traversal affects agents with file access
+```
+Agents는 파일을 읽고, 스크립트를 실행하고, codebases를 관리합니다. Path traversal 활성화:
+- 민감한 구성 파일 읽기 (.env, credentials)
+- SSH 키, API 토큰 접근
+- 긴요한 시스템 파일
+
+**공유 **
+```
+Score: Always HIGH
+Rationale: Command injection is critical in agent deployments
+```
+RCE와 마찬가지로 에이전트는 종종 시스템과 상호 작용하는 쉘 명령을 실행합니다. 명령 주입은 가득 차있는 체계 타협을 허용합니다.
+
+#### 중간 리스크 유형
+
+**Prototype 오염 (Node.js)* * 이름
+```
+Score: Elevated from LOW to MEDIUM
+Rationale: Prototype pollution can escalate in Node.js agents
+```
+많은 에이전트 프레임 워크는 Node.js에서 실행됩니다. Prototype 오염은 다음과 같습니다.
+- 인증 체크
+- 특전 에스컬레이션
+- 서비스 부인
+
+** SQL 주입 / NoSQL 주입 **
+```
+Score: Elevated to HIGH if network-accessible and unauthenticated
+Rationale: Injection affects agents with database access
+```
+데이터베이스의 대화 기록, 사용자 데이터 또는 도구 결과를 저장하는 에이전트는 주입 공격에 취약합니다.
+
+# # # # # # 낮잠 유형
+
+**Cross 사이트 스크립트 (XSS) * * 이름
+```
+Score: Reduced to MEDIUM if not network-accessible
+Rationale: XSS has limited impact in headless agents
+```
+일반적으로 브라우저에서 HTML을 렌더링하지 마십시오. XSS 충격을 줄입니다. 그러나 에이전트 관리 UI 또는 채팅 인터페이스의 XSS는 우려가 있습니다.
+
+# # # # # # # # # # # 4. 폭발성
+
+`--check-exploits`가 활성화되면 분석자는 공개 악용에 대한 참조 URL을 확인합니다.
+
+**Exploit 지표:**
+- 악용-db.com / 악용-database.com
+- 패킷stormsecurity.com
+- github.com/exploit, github.com/poc
+- metasploit 프레임 워크 모듈
+- "/exploit", "/poc", "/proof-of-concept" 포함 URL
+
+** 핵심 고각: **
+- `low` → `medium` (유효한)
+- `medium` → `high` (유효한)
+- `unknown` → `medium` (유효한 + CVSS > 0)
+
+**Rationale**: 공격자에 대한 기술 장벽을 낮추고 자동화 된 악용의 저명한 증가.
+
+## 득점 알고리즘
+
+해석기는 이 결정 나무를 따릅니다:
+
+```
+1. Parse CVSS score → set baseline (high/medium/low/unknown)
+2. Parse CVSS vector → analyze attack characteristics
+3. Adjust for attack vector:
+ - Network-accessible + no auth + no UI → elevate to HIGH
+ - Local-only access → reduce HIGH to MEDIUM
+4. Adjust for vulnerability type:
+ - Check against agent-specific risk categories
+ - Elevate or reduce score based on deployment context
+5. Check for public exploits (if enabled):
+ - Elevate score if exploits detected
+6. Generate rationale explaining the final score
+```
+
+## 예제
+
+### 예제 1 : 긴 RCE (높은 폭발성)
+
+```json
+{
+ "cve_id": "CVE-2024-12345",
+ "cvss_score": 9.8,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H",
+ "type": "remote_code_execution",
+ "description": "Unauthenticated RCE in Express.js framework"
+}
+```
+
+** 분석 출력 : **
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "Critical CVSS score (9.8); remotely exploitable without authentication; RCE is critical in agent deployments"
+}
+```
+
+**왜 높은 **: 긴요한 CVSS + 네트워크 접근 가능 + 아니 auth + RCE 유형.
+
+### 예제 2 : 에이전트 API의 SSRF (높은 폭발성)
+
+```json
+{
+ "cve_id": "CVE-2024-23456",
+ "cvss_score": 7.3,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:L/I:L/A:L",
+ "type": "server_side_request_forgery",
+ "description": "SSRF in webhook handler allows internal network access"
+}
+```
+
+** 분석 출력 : **
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "High CVSS score (7.3); remotely exploitable without authentication; SSRF affects agents making external requests"
+}
+```
+
+**Why HIGH**: SSRF는 API 호출을 하는 에이전트에 대 한 중요 한 (최대). 인증없이 네트워크 접근 가능 위험.
+
+### 예제 3 : 공공 폭발 (높은 폭발성)을 가진 경로 트레이널
+
+```json
+{
+ "cve_id": "CVE-2024-34567",
+ "cvss_score": 6.5,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N",
+ "type": "path_traversal",
+ "references": [
+ "https://exploit-db.com/exploits/51234",
+ "https://nvd.nist.gov/vuln/detail/CVE-2024-34567"
+ ]
+}
+```
+
+** 분석 출력 (-check-exploits 포함) : **
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "Medium CVSS score (6.5); network accessible; path traversal affects agents with file access; public exploit available (1 source)"
+}
+```
+
+**왜 높은 **: 경로 traversal + 에이전트 파일 액세스 + 공공 악용 높은 악용성에 중간 CVSS 상승.
+
+### 예제 4 : 에이전트 UI의 XSS (중간 폭발성)
+
+```json
+{
+ "cve_id": "CVE-2024-45678",
+ "cvss_score": 7.1,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:L",
+ "type": "cross_site_scripting",
+ "description": "Stored XSS in agent management dashboard"
+}
+```
+
+** 분석 출력 : **
+```json
+{
+ "exploitability_score": "medium",
+ "exploitability_rationale": "High CVSS score (7.1); network accessible; XSS has limited impact in headless agents"
+}
+```
+
+**왜 MEDIUM**: 높은 CVSS에도 불구하고, XSS는 에이전트 배포에 덜 중요 (헤드리스 작동). 사용자의 상호 작용을 요구합니다.
+
+### 예제 5 : 지역 Privilege 에스컬레이션 (중간 폭발성)
+
+```json
+{
+ "cve_id": "CVE-2024-56789",
+ "cvss_score": 8.8,
+ "cvss_vector": "CVSS:3.1/AV:L/AC:L/PR:L/UI:N/S:C/C:H/I:H/A:H",
+ "type": "privilege_escalation",
+ "description": "Local privilege escalation via symbolic link attack"
+}
+```
+
+** 분석 출력 : **
+```json
+{
+ "exploitability_score": "medium",
+ "exploitability_rationale": "High CVSS score (8.8); requires local access"
+}
+```
+
+**왜 MEDIUM **: 높은 CVSS에도 불구하고 로컬 액세스가 필요합니다. 일반적으로 로컬 에스컬레이션이 제한된 영향이 있는 컨테이너/샌드박스 환경에서 실행됩니다.
+
+### 예 6 : Exploit (High Exploitability)의 프로토 타입 오염
+
+```json
+{
+ "cve_id": "CVE-2024-67890",
+ "cvss_score": 5.3,
+ "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:L/A:N",
+ "type": "prototype_pollution",
+ "description": "Prototype pollution in lodash merge function",
+ "references": [
+ "https://github.com/exploit/prototype-pollution-poc",
+ "https://snyk.io/vuln/SNYK-JS-LODASH-1234567"
+ ]
+}
+```
+
+** 분석 출력 (-check-exploits 포함) : **
+```json
+{
+ "exploitability_score": "high",
+ "exploitability_rationale": "Medium CVSS score (5.3); remotely exploitable without authentication; prototype pollution can escalate in Node.js agents; public exploit available (1 source)"
+}
+```
+
+**왜 HIGH**: Node.js Agent + public exploit + network-accessible에 있는 Prototype 오염은 온건한 CVSS에도 불구하고 auth = 높은 위험이 없습니다.
+
+## ClawSec Workflows의 사용
+
+## 자동화된 득점 (NVD 급식)
+
+`poll-nvd-cves.yml` 워크플로우는 새로운 CVE를 자동적으로 평가합니다.
+
+```bash
+# Workflow step
+python utils/analyze_exploitability.py --json --check-exploits < cve-data.json
+```
+
+`advisories/feed.json`의 자문은 다음을 포함합니다:
+```json
+{
+ "id": "CVE-2024-12345",
+ "severity": "high",
+ "exploitability_score": "high",
+ "exploitability_rationale": "Critical CVSS score (9.8); remotely exploitable without authentication; RCE is critical in agent deployments",
+ "attack_vector_analysis": {
+ "is_network_accessible": true,
+ "requires_authentication": false,
+ "requires_user_interaction": false,
+ "complexity": "low"
+ }
+}
+```
+
+## 수동 분석
+
+보안 연구원은 수동으로 CVE를 분석 할 수 있습니다 :
+
+```bash
+# Basic analysis
+echo '{"cve_id":"CVE-2024-12345","cvss_score":7.3,"type":"ssrf"}' | \
+ python utils/analyze_exploitability.py --json
+
+# With exploit detection
+echo '{"cve_id":"CVE-2024-12345","cvss_score":7.3,"references":["https://exploit-db.com/exploits/51234"]}' | \
+ python utils/analyze_exploitability.py --json --check-exploits
+```
+
+### Exploitability에 의해 필터링
+
+사용자는 악용성 점수에 의해 고문을 필터링 할 수 있습니다:
+
+```bash
+# Get only high-exploitability advisories
+curl -s https://clawsec.prompt.security/feed.json | \
+ jq '.advisories[] | select(.exploitability_score == "high")'
+
+# Prioritize by exploitability and severity
+curl -s https://clawsec.prompt.security/feed.json | \
+ jq '[.advisories[] | select(.exploitability_score == "high" and .severity == "critical")] | sort_by(.cvss_score) | reverse'
+```
+
+## Backfilling Existing Advisories (역사적 유지보수)
+
+사이트맵 QXZ는 One-off 저장소 유지 보수를 위한 역사적인 유지 보수 유틸리티로 유지됩니다.
+정상적인 자문 세대의 기본 경로는 아닙니다.
+
+선호하는 경로:
+
+1. 명세 CI canonical 경로: init/reset과 NVD 워크플로우를 실행하여 NVD의 자문을 재개하고 파이프라인에 있는 Artifacts를 서명합니다.
+2. 명세 로컬 개발자 경로: `./scripts/populate-local-feed.sh --force`를 실행하여 지역 피드를 분산시킵니다.
+
+명시적으로 레거시 피드 콘텐츠를 복구 할 때 backfill을 사용합니다.
+
+## 커뮤니티 공헌
+
+커뮤니티 회원은 악용성 평가를 제출할 수 있습니다.
+
+1. 명세 ** GitHub Issue를 통해 등록 **: CVE를 악용성 컨텍스트로 보고하기 위한 자문 템플릿 사용
+2. 명세 ** 자동화된 분석**: `community-advisory.yml` 워크플로우는 커뮤니티에 등록한 CVE를 자동으로 평가합니다.
+3. 명세 ** 수동 검토 **: 유지자 검토 및 승인
+4. 명세 **Feed Update** : 승인 된 자문은 악용성 점수로 피드에 추가됩니다.
+
+## 제한 및 미래 작업
+
+## 현재 제한
+
+1. 명세 **Static Analysis**: Scoring은 CVE metadata를 기반으로 동적 실행 시간 분석이 아닙니다.
+2.**No Version Detection**: 특정 버전이 취약하다면 확인하지 않습니다.
+3. 명세 ** 일정 **: 부분적인 mitigation 또는 Defense-in-depth을 고려하지 마십시오.
+4. 명세 **Limited Context**: 정확한 에이전트 구성 또는 배포 툴을 알 수 없습니다.
+
+### 미래 향상
+
+1. 명세 **EPSS 통합 **: EPSS (Exploit Prediction Scoring System) 확률 점수
+2. 명세 **KEV Matching**: CISA KEV(Known Exploited Vulnerabilities) 카탈로그를 사용한 Cross-reference
+3. 명세 **Agent Profiling**: 배포된 에이전트 기능과 노출된 API를 고려
+4. 명세 **Mitigation Detection**: WAF 규칙, 샌드박스링, 기타 보상 제어를 확인
+5. 명세 **ML 기반 득점 **: 기계 학습을 사용하여 악용성을 예측합니다.
+
+## 참조
+
+- **CVSS v3.1 사양**: [https://www.first.org/cvss/v3.1/specification-document](https://www.first.org/cvss/v3.1/specification-document)
+- **CVSS v2 가이드**: [https://www.first.org/cvss/v2/guide](https://www.first.org/cvss/v2/guide)
+- **EPSS**: [https://www.first.org/epss/](https://www.first.org/epss/)
+- **CISA KEV **: [https://www.cisa.gov/known-exploited-vulnerabilities-catalog](https://www.cisa.gov/known-exploited-vulnerabilities-catalog)
+- **NVD API**: [https://nvd.nist.gov/developers/vulnerabilities](https://nvd.nist.gov/developers/vulnerabilities)
+
+# # # # # # # # # # 관련 기사
+
+악용성 득점 방법론을 개량하기 위하여:
+
+1. 명세 **Submit Test Case**: `utils/analyze_exploitability.py`에 대한 테스트 케이스 추가
+2. 명세 **Report False Positives/Negatives**: CVE 예제에서 GitHub 이슈 열기
+3. 명세 **Propose Scoring Adjustments**: 합리적이고 예로 PR 제출
+4. 명세 **Share Agent Context**: Contribute 에이전트별 취약성 패턴
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for detailed contribution guidelines.
+
+--- ---
+
+**가입 **: [Prompt Security](https://prompt.security)
+**라이센스 **: AGPL-3.0-or-later
+**최근 업데이트 **: 2026-03-01
diff --git a/wiki/ko/glossary.md b/wiki/ko/glossary.md
new file mode 100644
index 0000000..6c7274a
--- /dev/null
+++ b/wiki/ko/glossary.md
@@ -0,0 +1,64 @@
+
+
+₢ 킹 회사 소개
+
+> 핵심 용어: `clawsec-suite`
+
+## 약관
+| 용어 | 정의 |
+인포메이션
+| Advisory Feed | JSON 문서(`feed.json`)는 기술/플랫폼에 대한 보안 자문을 포함하고 있습니다. ·
+| 액티베이터 | `skill@1.2.3`, 와일드카드 등의 스킬 셀렉터, 또는 일치 논리에 사용되는 범위. ·
+| Guarded Install | 고문 경기시 명시적 확인이 필요한 2단계 설치 동작. ·
+| SBOM 파일 | 포장 및 검증을 위해 사용되는 `skill.json`의 숙련도 목록. ·
+| 시그니처 | Base64 시그니처 파일(`.sig`)는 서명된 페이로드에서 별도로 저장됩니다. ·
+| Checksum Manifest | 파일 해시 맵(`checksums.json`)은 페이로드 무결성을 검증하는 데 사용됩니다. ·
+
+## 기술 포장 기간
+| 용어 | 정의 |
+인포메이션
+| 기술 태그 | Git 태그는 릴리스 자동화에 의해 사용되는 `-v`로 포맷되었습니다. ·
+| Release Assets | GitHub 릴리스에 첨부된 파일(zip, `skill.json`, 체크섬, 서명) ·
+| 카탈로그 인덱스 | `public/skills/index.json`, 웹 카탈로그에 의해 생성 된 목록. ·
+| 임베디드 부품 | 또 다른 한 기술로부터의 기능 번들(예를 들어, 스위트에 임베디드) ·
+
+## 자문 및 보안 약관
+| 용어 | 정의 |
+인포메이션
+| Fail-Closed Verification | 시그니처 또는 체크섬 유효성 검사가 실패한 경우 급여를 거부합니다. ·
+| 할당된 호환성 모드 | `CLAWSEC_ALLOW_UNSIGNED_FEED=1`를 통한 임시 우회 경로. ·
+| Suppression Rule | `checkId` 및 `skill`와 일치하는 컨피케이트를 구성하여 알려진 발견을 억제합니다. ·
+| 키 지문 | SHA-256 키 일관성 검사에 사용되는 DER-encoded 공공 키의 소화. ·
+
+## 런타임 및 플랫폼 약관
+| 용어 | 정의 |
+인포메이션
+| OpenClaw Hook | 런타임 이벤트 핸들러(`clawsec-advisory-guardian`) ·
+| NanoClaw IPC | 자문을 위한 호스트/컨테이너 작업 교환, 서명 검증, 무결성 검사. ·
+| Integrity Baseline | 보호된 파일용 hashes/snapshot를 저장했습니다. ·
+| 해시체인 감사 로그 | 각 항목이 이전 해시에 따라 달라집니다. ·
+
+## CI/CD 이용 약관
+| 용어 | 정의 |
+인포메이션
+| Poll NVD CVEs Workflow | NVD CVEs를 고문으로 바꾸는 워크플로를 계획했습니다. ·
+| Community Advisory Workflow | 승인된 커뮤니티 자문을 출판하는 이슈 라벨 트리거 워크. ·
+| 스킬 릴리즈 워크플로 | 태그 트리거 포장/신호/신호 파이프라인 기술 ·
+| 배포 페이지 워크플로우 | 사이트 자산과 미러링/사설물을 구축하는 워크플로우. ·
+
+## 소스 참조
+- 유형.ts
+- 기술/하프스위트/skill.json
+- 기술/하프-nanoclaw/skill.json
+- 기술/클래스/scripts/guarded_skill_install.mjs
+- 기술/하프스위트/훅/하프스위트 자문/lib/feed.mjs
+- 기술/하프스위트/훅/하프스위트 자문/lib/suppression.mjs
+- 기술/하프-nanoclaw/guardian/integrity-monitor.ts
+- 스크립트/populate-local-feed.sh
+- .github/workflows/poll-nvd-cves.yml의 경우
+- .github/workflows/community-advisory.yml
+- .github/workflows/skill-release.yml의 경우
+- .github/workflows/deploy-pages.yml의 경우
diff --git a/wiki/ko/localization.md b/wiki/ko/localization.md
new file mode 100644
index 0000000..c7c8d25
--- /dev/null
+++ b/wiki/ko/localization.md
@@ -0,0 +1,66 @@
+# 로컬라이제이션 워크플로우 (한국어)
+
+## 목적
+ClawSec README 및 위키 문서를 반복 가능하게 번역/현지화하기 위한 표준 파이프라인을 정의합니다.
+
+## 범위
+- 원문(정본) 언어: 영어 (`README.md`, `wiki/*.md`)
+- 현재 번역 언어: 스페인어 (`README.es.md`, `wiki/es/*.md`)
+- 한국어 파일럿 언어: 한국어 (`README.ko.md`, `wiki/ko/*.md`)
+- 향후 언어: `wiki//...`, `README..md`
+
+## Source of Truth 규칙
+1. 영어 문서가 정본입니다.
+2. 번역 시 명령어, 파일 경로, 코드 블록, 식별자는 원문과 동일하게 유지합니다.
+3. 제품/스킬 이름은 번역하지 않습니다 (`ClawSec`, `OpenClaw`, `NanoClaw`, `Hermes`, `Picoclaw`, 스킬 패키지명).
+4. 번역 커버리지가 부분적일 경우, 번역 문서에 범위를 명시합니다.
+
+## 폴더 규칙
+- README 번역:
+- `README.es.md`의
+ - `README.ko.md`
+ - 향후 예시: `README.fr.md`, `README.de.md`, `README.ja.md`
+- 위키 번역:
+ - `wiki/es/INDEX.md`, `wiki/es/.md`
+ - `wiki/ko/INDEX.md`, `wiki/ko/.md`
+ - 향후 예시: `wiki/fr/.md`, `wiki/de/.md`
+- 로컬라이제이션 자산:
+- `wiki/i18n/terminology-en-es.md`의
+- `wiki/i18n/translation-tracker.md`의
+ - `scripts/i18n/qa_check.py`
+
+## 업데이트 워크플로우
+1. **원문 정리 우선**
+ - 번역 전에 영어 원문의 구조/명확성을 먼저 정리합니다.
+2. **변경 추적**
+ - `wiki/i18n/translation-tracker.md`에 변경 페이지를 기록합니다.
+3. **변경분 번역**
+ - Markdown 구조(헤더 레벨/링크/코드 블록)를 보존합니다.
+4. **QA 점검**
+ - 링크 해상도, 코드 블록/인라인 명령어 불변성, 용어 일관성을 확인합니다.
+5. **내보내기 재생성**
+ - `npm run gen:wiki-llms` 실행.
+6. **리뷰 및 PR**
+ - 번역 완료 페이지와 미완료 범위를 PR에 명시합니다.
+
+## 번역 QA 체크리스트
+- [ ] 헤더 계층 유지
+- [ ] 명령어 스니펫 불변 및 실행 가능
+- [ ] 파일 경로/URL 불변
+- [ ] 스킬/플랫폼 이름 불변
+- [ ] 보안 용어 일관성
+- [ ] `wiki/INDEX.md`에 번역 링크 존재
+- [ ] `wiki//INDEX.md`에서 미번역 문서는 영어 원문으로 연결
+
+## 권장 언어 확장 순서
+1. 스페인어 (`es`) — 기본선 완료
+2. 한국어 (`ko`) — 파일럿 진행 중
+3. 프랑스어/독일어 (`fr`, `de`) — 기술 사용자층 확장
+4. 일본어 (`ja`) — 고품질 플랫폼 문서 확장
+
+## 소스 참조
+- `wiki/localization.md`
+- `wiki/es/localization.md`
+- `wiki/ko/INDEX.md`
+- `wiki/i18n/translation-tracker.md`
+- `scripts/i18n/qa_check.py`
diff --git a/wiki/ko/migration-signed-feed.md b/wiki/ko/migration-signed-feed.md
new file mode 100644
index 0000000..a3ee0f5
--- /dev/null
+++ b/wiki/ko/migration-signed-feed.md
@@ -0,0 +1,185 @@
+
+
+# 마이그레이션 기록 : 위임 된 피드 → 서명 피드 (완료)
+
+# # # # # # # # # # 1) 목표 및 상태
+
+ClawSec 자문 배포가 서명되지 않은 `feed.json` 납품에서 레거시 클라이언트를 위해 보존 된 호환성과 함께 분리 된 서명 확인을 수행하는 방법 문서.
+
+`main`의 현재 상태:
+- Signed Feed Publishinging은 자문 작업 흐름과 워크플로우를 배치하는 역할을 합니다.
+- Suite 및 NanoClaw 소비자는 기본적으로 피드 엔드포인트를 서명합니다.
+- 별도의 호환성 우회(`CLAWSEC_ALLOW_UNSIGNED_FEED=1`)만 존재합니다.
+
+# # # # # # # # # # 2) 기본 (일, 포스트 마이그레이션)
+
+활성 사용의 현재 공급 경로:
+- 진실의 근원: `advisories/feed.json`
+- 소스 서명 : `advisories/feed.json.sig`
+- 기술 복사 : `skills/clawsec-feed/advisories/feed.json`
+- 기술 사본 서명: `skills/clawsec-feed/advisories/feed.json.sig`
+- 페이지 사본: `public/advisories/feed.json`
+- 페이지 서명: 사이트맵
+- 최신 미러 복사 : `public/releases/latest/download/advisories/feed.json` (+ `.sig`)
+
+현재 소비자 과태:
+- `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`의
+- `skills/clawsec-suite/scripts/guarded_skill_install.mjs`의
+- `skills/clawsec-nanoclaw/lib/advisories.ts`의
+- 기본 URL: `https://clawsec.prompt.security/advisories/feed.json`
+
+# # # # # # # # # # 3) 마이그레이션 원리
+
+-**Dual-publish first**: 검증을 위해 서명을 게시합니다.
+- ** 전환 중 만 실패 - ** : 임시 호환성 기간은 명시되어 있으며 시간 제한.
+-**Measured rollout**: telemetry 후의 검증은 안정적인 서명 게시를 확인합니다.
+-**Fast rollback**: 루트 원인이 조사되는 동안 불신명한 행동으로 다시 길을 보존합니다.
+
+# # # # # # # # # # 4) 단계별 타임라인 (historical)
+
+# # # # # # # # # # # 단계 0 - 준비 (완료)
+
+공급 능력:
+- 기록된 키 및 지문 서명
+- GitHub 비밀 생성
+- 대중 키 (s) repo에 추가
+- runbooks 승인 (`security-signing-runbook.md`,이 파일)
+
+출구 기준:
+- 검토자가 확인한 키 지문
+- 보호된 분지/workflow 통제 활성화
+
+# # # # # # # # # # # 단계 1 - CI 서명 활성화, 클라이언트 집행 없음 (완료)
+
+구현 :
+- `advisories/feed.json.sig`를 생성하는 급식 서명 단계/작업 흐름을 추가하십시오
+- 선택적으로 생성 `advisories/checksums.json` + `.sig`
+- CI는 게시하기 전에 서명을 검증합니다.
+
+또한 업데이트 배포:
+- `.sig` artifacts를 `public/advisories/`로 복사
+- `.sig`의 미러 `.sig`
+
+출구 기준:
+- 모든 피드 업데이트 경로에 성공적으로 생성 된 서명
+- 배치 artifacts는 payload와 서명 동반자를 포함합니다
+
+# # # # # # # # # # # 주요연혁 2 — 소비자 듀얼-레드/듀얼-verify 지원 (완료)
+
+소비자의 구현:
+- `feed.json` 및 `feed.json.sig`를 읽으십시오
+- pinned public key로 확인
+- 이동 창 도중 통제되는 임시 불이행한 fallback를 지킵니다
+
+유효성:
+- 테스트 원격 서명 경로
+- 로컬 서명된 fallback 경로 테스트
+- 테스트 잘못된 서명 거부
+
+출구 기준:
+- 검증 논리 및 테스트
+- 적시에 부정적 검증 실패 없음
+
+# # # # # # # # # # # 3 단계 - 시행 (완료)
+
+활동 :
+- 기본 경로의 일시적 불이행된 fallback 동작
+- `.sig`가 누락될 때 실패한 CI/publish 문을 추가하십시오
+- 릴리스 노트 및 docs의 시행일 발표
+
+출구 기준:
+- 모든 생산 클라이언트는 기본적으로 서명을 확인합니다
+- 표준 임명 교류에 있는 unsigned 급식 의존도 없음
+
+# # # # # # # # # # # 주요연혁 4 - 안정화 (Ongoing)
+
+활동 :
+- 첫번째 열쇠 교체 탁상 교련을 달리십시오
+- 롤백 탁상 드릴 실행
+- post-implementation 검토와 가까운 이동
+
+# # # # # # # # # # 5) 롤백 계획
+
+## 롤백 트리거
+
+다음의 경우 롤백을 시작:
+- 클라이언트의 지속적인 서명 검증 실패
+- 서명 워크플로는 유효한 서명을 생성할 수 없습니다
+- 키 손상 의심하지만 교체 키는 아직 배포되지 않습니다
+- 배포 경로는 잘못된 payload/signature 쌍을 게시
+
+## # 롤백 레벨
+
+## 레벨 1 (preferred): Verification bypass 창, 서명된 게시 유지
+
+사용될 때: signing는 건강합니다, 클라이언트 측 verifier에는 결함이 있습니다.
+
+활동 :
+1. 명세 클라이언트 릴리스 지점의 임시 취소 방지 동작.
+2. 명세 bypass에 대한 명시된 만료 날짜와 선박 패치 릴리스.
+3. 명세 정품 간격을 피하기 위해 파이프라인을 서명하십시오.
+
+복구 대상 : 24 ~ 48h 이내에 엄격한 검증을 복원합니다.
+
+### 레벨 2: 서명된 파이프라인 일시적으로 권한이 없는, 위탁된 급식
+
+사용될 때: signing 파이프라인은 불안정하거나 inconsistent artifacts를 일으키.
+
+활동 :
+1. 명세 작업 흐름 또는 서명 단계가 비활성화됩니다.
+2. 기존 워크플로우를 통해 `advisories/feed.json`를 서명하지 않는 것을 계속합니다.
+3. 명세 `.sig` artifacts가 필요한 게이트를 다시 배포합니다.
+4. 명세 사건 기록 및 추적 시간 표시되지 않은 모드에서.
+
+복구 대상 : 서명 된 출판 ASAP, 이상적으로 <72h.
+
+### 레벨 3: 전체 릴리스 동결
+
+사용될 때: repository/workflows의 타협 또는 완전성은 의심합니다.
+
+활동 :
+1. 명세 Pause feed mutation 및 배포 워크플로우.
+2. 명세 자문 파일 / 워크 플로에 대한 알려진 좋은 커밋 복원.
+3. 명세 열쇠와 자격.
+4. 명세 보안 검토 표지판 후만 이력서 파이프라인.
+
+## 롤백 후 롤백
+
+- 루트 원인 확인
+- 회귀 테스트/게이트 추가
+- redeploy 서명된 artifacts
+- 출판사 사건 + 재화 요약
+
+# # # # # # # # # # 6) 통신 계획
+
+시행 및 롤백 이벤트의 경우, 통신 :
+- 어떤 변경
+- 예상 연산자/클라이언트 작업
+- 임시 겸용성 형태의 내구 (모든 경우에)
+- 사용자의 검증 명령
+
+권장 채널:
+- GitHub 릴리스 노트
+- 저장소 README/docs 업데이트
+- repository에 있는 문제점/incident 보고
+
+# # # # # # # # # # 7) Go/No-Go 체크리스트
+
+모두 true인 경우에만 이동하십시오:
+- 대화 워크플로 성공률은 안정
+- 서명은 모든 문서 피드 엔드포인트에 미러링됩니다.
+- 원격 + 로컬 fallback에 대한 소비자 검증 경로 테스트
+- 롤백 소유자는 할당 및 도달 가능
+- 열쇠 교체 절차는 적어도 한 번 말립니다
+
+## 소스 참조
+- .github/workflows/poll-nvd-cves.yml의 경우
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml의 경우
+- 기술/하프스위트/훅/하프스위트 자문/handler.ts
+- 기술/클래스/scripts/guarded_skill_install.mjs
+- 고문/feed.json
+- 위키 / 보안 - 서명 - Runbook.md
diff --git a/wiki/ko/overview.md b/wiki/ko/overview.md
new file mode 100644
index 0000000..bca3c37
--- /dev/null
+++ b/wiki/ko/overview.md
@@ -0,0 +1,52 @@
+# Overview (한국어)
+
+## 목적
+- ClawSec은 OpenClaw 및 NanoClaw 환경을 위한 공개 웹 카탈로그와 설치형 보안 스킬을 결합한 보안 중심 저장소입니다.
+- 정적 사이트 배포, 서명된 advisory 배포, clawsec-suite 같은 스킬 단위 GitHub 릴리스 패키징을 동시에 지원합니다.
+
+## 저장소 구성
+| 경로 | 역할 | 비고 |
+인포메이션
+| `pages/`, `components/`, `App.tsx`, `index.tsx` | Vite + React UI | 스킬 카탈로그, advisory 피드, 상세 페이지 |
+| `skills/` | 보안 스킬 패키지 | 각 스킬은 `skill.json`, `SKILL.md`, 선택적 scripts/tests/docs 포함 |
+| `advisories/` | 리포지토리 advisory 채널 | 서명된 `feed.json` + `feed.json.sig` |
+| `scripts/` | 로컬 자동화 | feed/skills populate, pre-push 점검, release helper |
+| `.github/workflows/` | CI/CD 파이프라인 | CI, release, NVD polling, pages deploy |
+| `wiki/` | 문서 허브 | 아키텍처, 운영 런북, 검증 가이드 |
+
+## 진입점
+- `index.tsx`: React 앱 부트스트랩
+- `App.tsx`: 라우트 정의 (`/`, `/skills`, `/feed`, `/wiki/*`)
+- `scripts/prepare-to-push.sh`: 로컬 품질 게이트
+- `scripts/generate-wiki-llms.mjs`: wiki `llms.txt` 생성
+
+## 핵심 워크플로우
+1. 로컬 개발: `npm install && npm run dev`
+2. 로컬 데이터 미리보기:
+ - `./scripts/populate-local-skills.sh`
+ - `./scripts/populate-local-feed.sh --days 120`
+3. 품질 게이트: `./scripts/prepare-to-push.sh`
+
+## 예시 명령
+```bash
+npm install
+./scripts/populate-local-skills.sh
+./scripts/populate-local-feed.sh --days 120
+npm run dev
+```
+
+## 참고
+- 상세 기준 문서는 영어 원문을 참고하세요: [../overview.md](../overview.md)
+- 위키 인덱스(한국어): [INDEX.md](INDEX.md)
+
+## 업데이트 노트
+- 2026-04-27: 한국어 overview 초기 버전 추가.
+
+## 소스 참조
+- `README.md`
+- `App.tsx`
+- `index.tsx`
+- `scripts/prepare-to-push.sh`
+- `scripts/populate-local-feed.sh`
+- `scripts/populate-local-skills.sh`
+- `scripts/generate-wiki-llms.mjs`
diff --git a/wiki/ko/platform-verification.md b/wiki/ko/platform-verification.md
new file mode 100644
index 0000000..f2ce49e
--- /dev/null
+++ b/wiki/ko/platform-verification.md
@@ -0,0 +1,103 @@
+
+
+# 플랫폼 검증 체크리스트
+
+이 체크리스트를 사용하여 변경 후 포트성과 경로 추적 작업을 검증합니다.
+
+## 리눅스 검증
+
+1. 명세 핵심 노드 테스트를 실행:
+ ```bash
+ node skills/clawsec-suite/test/path_resolution.test.mjs
+ node skills/clawsec-suite/test/guarded_install.test.mjs
+ node skills/clawsec-suite/test/advisory_suppression.test.mjs
+ node skills/openclaw-audit-watchdog/test/suppression_config.test.mjs
+ ```
+예상 : 모든 테스트 패스.
+
+2. 명세 리터 `$HOME` 경로 합격을 확인:
+ ```bash
+ CLAWSEC_LOCAL_FEED='\$HOME/advisories/feed.json' \
+ node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+ ```
+예상 : `Unexpanded home token` 오류로 비소를 종료합니다.
+
+3. `$HOME` 확장 작품을 검증:
+ ```bash
+ HOME=/tmp/clawsec-home node skills/clawsec-suite/test/path_resolution.test.mjs
+ ```
+예상되는: `$HOME` 확장 시험 통행.
+
+## macOS 인증
+
+1. 명세 같은 노드 테스트 스위트를 Linux로 실행합니다.
+2. OpenSSL 도구 경로 가정을 확인:
+- LibreSSL/OpenSSL 변형을 사용하는 경우, docs에서 테스트된 명령 양식을 확인합니다.
+3. 명세 config 경로에서 tilde 확장을 검증:
+ ```bash
+ OPENCLAW_AUDIT_CONFIG=~/.openclaw/security-audit.json \
+ node skills/openclaw-audit-watchdog/scripts/load_suppression_config.mjs --enable-suppressions
+ ```
+예상 : 경로는 올바르게 해결 (또는 확장 된 위치에 명확한 파일 기반 오류).
+
+## 윈도우 검증 (PowerShell)
+
+1. 명세 Node 테스트 실행:
+ ```powershell
+ node skills/clawsec-suite/test/path_resolution.test.mjs
+ node skills/clawsec-suite/test/guarded_install.test.mjs
+ node skills/clawsec-suite/test/advisory_suppression.test.mjs
+ ```
+예상 : 모든 패스.
+
+2. 명세 공급 능력 Shell env 경로 확장 동작:
+ ```powershell
+ $env:CLAWSEC_LOCAL_FEED = '$env:USERPROFILE\advisories\feed.json'
+ node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+ ```
+예상 : 경로 토큰은 확장 / 정상화 또는 대상 파일이 누락 된 경우 명확한 오류로 실패합니다.
+
+3. 명세 탈출 된 리터럴 토큰 거부 :
+ ```powershell
+ $env:CLAWSEC_LOCAL_FEED = '\$HOME\advisories\feed.json'
+ node skills/clawsec-suite/scripts/guarded_skill_install.mjs --skill test-skill --dry-run
+ ```
+예상 : `Unexpanded home token` 오류; 리터 `$HOME`와 디렉토리 생성.
+
+# # # # # # # # # # 라인 종료 Sanity
+
+1. 명세 LF 정책 확인은 현재:
+ ```bash
+ test -f .gitattributes && grep -n "eol=lf" .gitattributes
+ ```
+예상 : 스크립트 / 구성 파일 패턴은 LF를 적용합니다.
+
+2. 명세 CRLF-prone 체크 아웃 후, 여전히 스크립트를 확인:
+ ```bash
+ bash -n scripts/populate-local-feed.sh
+ bash -n scripts/populate-local-skills.sh
+ ```
+예상 : `^M` shebang/parse 오류가 없습니다.
+
+## Explicit 버그 검사: 리터 `$HOME` 없음 연락처
+
+1. 명세 리터/escaped 토큰으로 경로 구성.
+2. 명세 설정/설치 명령을 실행합니다.
+3. 명세 Verify 명령은 토큰 오류로 일찍 실패합니다.
+4. `$HOME` 세그먼트 디렉토리가 작업 디렉터리에 생성되지 않았습니다.
+
+예상 결과: **Laral `$HOME`를 포함하는 디렉터리가 지원되는 설정 스크립트에 의해 생성됩니다. 더 보기
+
+## 소스 참조
+- .gitattributes의
+- 스크립트/populate-local-feed.sh
+- 스크립트/populate-local-skills.sh
+- 기술/클래스/테스트/path_resolution.test.mjs
+- 기술/클래스/테스트/guarded_install.test.mjs
+- 기술/하프스위트/테스트/advisory_suppression.test.mjs
+- 기술/클래스/scripts/guarded_skill_install.mjs
+- 기술/openclaw-audit-watchdog/scripts/load_suppression_config.mjs
+- 기술/openclaw-audit-watchdog/test/suppression_config.test.mjs
diff --git a/wiki/ko/remediation-plan.md b/wiki/ko/remediation-plan.md
new file mode 100644
index 0000000..4ecba9f
--- /dev/null
+++ b/wiki/ko/remediation-plan.md
@@ -0,0 +1,89 @@
+
+
+# 교차 플랫폼 구제 계획
+
+# # # # # # # # # # 단계 1: 즉시 위험 폐쇄 (완료)
+
+## 마일스톤
+- 명시된 홈-경로 확장 + 높은-리스크 런타임/설치 경로의 의심스러운 토큰 거부 구현.
+- 경로 확장 및 탈출을 위한 회귀 테스트 추가.
+- `.gitattributes` LF 정책을 추가하십시오.
+- Linux/macOS/Windows에 Node lint/type/build CI 적용을 확장합니다.
+- 업데이트는 shell-specific 지도와 리터럴 `$HOME` 문제 해결과 함께 docs를 설치합니다.
+
+## # 결과
+- 리터 `$HOME` 경로 propagation 버그는 소스에 주소.
+- Core advisory/install 경로 설정은 이제 잘못된 경로 토큰에 빠지지 않습니다.
+
+--- ---
+
+# # # # # # # # # # 단계 2: 긴요한 워크 플로우에 대한 Windows Parity (다음)
+
+## 빠른 승리
+- 전원 추가 Shell은 가장 많이 사용되는 수동 설치 / 체크 명령에 해당합니다.
+- `skills/clawsec-suite/SKILL.md`의
+- `skills/openclaw-audit-watchdog/SKILL.md`의
+- `README.md`의
+- 경량 `scripts/preflight.mjs`를 추가하여 누락된 도구와 인쇄 OS-특수 설치 힌트를 감지합니다.
+
+## 마일스톤
+- 네이티브 파워 스위트 설정 및 자문 후크에 대한 쉘 지침.
+- WSL/Git Bash fallback은 쉘 스크립트가 비례 없는 곳에 문서화되었습니다.
+
+--- ---
+
+# # # # # # # # # # 단계 3: POSIX 감소 포탄 표면 (Deeper Refactor)
+
+## Refactor 대상
+- `scripts/populate-local-feed.sh`의
+- `scripts/populate-local-skills.sh`의
+- `scripts/release-skill.sh`의
+
+### 접근
+- `jq/sed/awk/find/chmod` 파이프라인에 의존성을 제거하기 위해 Node/Python의 중요한 경로 재개.
+- 백워드 호환성을 위한 예비 쉘 래퍼; 새로운 크로스 플랫폼 구현 경로.
+
+### 마이그레이션 노트
+- 적어도 하나의 미성년자 릴리스에 대한 래퍼로 오래된 스크립트 엔트리 포인트를 유지.
+- 정확한 마이그레이션 명령으로 경고를 전송합니다.
+
+--- ---
+
+# # # # # # # # # # 4 단계 : CI 경화 및 양파 검증
+
+## 마일스톤
+- 필요한 체크로 Node matrix (Linux/macOS/Windows)를 유지하십시오.
+- 설치 경로 처리를위한 대상 Windows 연기 테스트 추가.
+- macOS 체크를 OpenSSL 명령 호환성 메모에 추가하십시오.
+
+# # # # # # # # # # # 시험 전략
+- 지역:
+- 경로 확장/suppression/install 동작을 커버하는 Node Test Suite를 실행합니다.
+- 수정된 스크립트를 위한 구문 체크를 실행합니다.
+- CI:
+- Matrix Node 체크 + 가드 설치 프로그램 / 압축 / 경로 테스트.
+- Linux 전용 보안 검사는 남아 있지만 Linux-scoped로 표시되어 있습니다.
+
+--- ---
+
+## 롤아웃 / 출시 고려
+
+- - - 이 패치 세트에 도입 된 인터페이스 변경 없음; 동작은 잘못된 / 예상 경로 토큰에만 엄격합니다.
+- 릴리스 노트에서 Communicate:
+- 경로 토큰 유효성 검증
+- 잘못된 인용 된 env 값을 수정하는 방법
+- 어디 힘 Shell 예제
+
+## 소스 참조
+- .gitattributes의
+- .github/workflows/ci.yml의 경우
+- 스크립트/populate-local-feed.sh
+- 스크립트/populate-local-skills.sh
+- 스크립트/출시-skill.sh
+- 기술/하프스위트/훅/하프스위트 자문/handler.ts
+- 기술/클래스/scripts/guarded_skill_install.mjs
+- 기술/openclaw-audit-watchdog/scripts/load_suppression_config.mjs
+- 위키/platform-verification.md
diff --git a/wiki/ko/security-signing-runbook.md b/wiki/ko/security-signing-runbook.md
new file mode 100644
index 0000000..34a43b8
--- /dev/null
+++ b/wiki/ko/security-signing-runbook.md
@@ -0,0 +1,239 @@
+
+
+# ClawSec 서명 작업 Runbook
+
+# # # # # # # # # # # 1) 목적
+
+이 runbook은 ClawSec 저장소에 암호화 서명을 도입하고 실행하기위한 작업 절차를 정의합니다.
+
+그것은 덮습니다:
+- 키 생성
+- GitHub 비밀 관리
+- 작업 흐름 통합 서명
+- 키 교체 및 재발급
+- 사건 응답
+
+# # # # # # # # # # 2) 현재 운영 국가 (위탁자)
+
+`main`에서 고문 및 릴리스 채널은 기본적으로 서명하고 검증됩니다.
+
+- 급식 작가:
+- `.github/workflows/poll-nvd-cves.yml` 업데이트 `advisories/feed.json` 및 표지 `advisories/feed.json.sig`
+- `.github/workflows/community-advisory.yml`는 승인된 문제점 보고를 위해 동일합니다
+- 둘 다 동기화는 `skills/clawsec-feed/advisories/`로 공식 급식 artifacts를 서명했습니다
+- 피드 출판 경로:
+- `.github/workflows/deploy-pages.yml` 발행 `public/advisories/feed.json` + `.sig`
+- 생성 및 표시 `public/checksums.json` + `public/checksums.sig`
+- `public/signing-public.pem` 및 `public/advisories/feed-signing-public.pem`로 canonical 키 게시
+- `public/releases/latest/download/` (`feed.json`, `feed.json.sig`, `checksums.json`, `checksums.sig`, `signing-public.pem` 포함)의 미러 호환성 예측
+- 공급 소비자:
+- `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`의
+- `skills/clawsec-suite/scripts/guarded_skill_install.mjs`의
+- `skills/clawsec-nanoclaw/lib/advisories.ts`의
+- 기본 피드 URL은 `https://clawsec.prompt.security/advisories/feed.json`입니다.
+
+지정되지 않은 모드는 명시된 호환성 우회 (`CLAWSEC_ALLOW_UNSIGNED_FEED=1`)에 남아 있으며 꾸준한 운영 모델이 아닙니다.
+
+# # # # # # # # # # 3) 표적 서명된 artifacts
+
+### 자문 피드 채널
+- `advisories/feed.json` (페이로드)
+- `advisories/feed.json.sig` (Ed25519 서명; base64)
+- `advisories/feed-signing-public.pem` (핀 공공 키)
+
+# # # # # # # # # # # artifact 채널 출시
+- `/checksums.json`의
+- `/checksums.sig`의
+- `/signing-public.pem`의
+
+# # # # # # # # # # 4) 중요한 역할 및 custody
+
+- ** 보안 소유자 ** : 키 수명주기 변경 및 사고 조치를 승인하십시오.
+- **플랫폼 소유자**: 워크플로우와 GitHub 비밀 유지.
+-**Reviewer**: PRs/releases의 지문을 검증합니다.
+
+정책:
+- 개인 키는 결코 최선을 다하고 있지 않습니다.
+- 공공 키는 최선을 다하고 코드 검토
+- 키 생성은 신뢰할 수있는 연산자 워크스테이션 또는 HSM 백업 환경에 발생합니다.
+
+# # # # # # # # # # 5) 키 생성 (Ed25519)
+
+· 안전한 워크스테이션에서 실행. CI 런너를 공유하지 마십시오.
+
+```bash
+# Feed signing keypair
+openssl genpkey -algorithm Ed25519 -out feed-signing-private.pem
+openssl pkey -in feed-signing-private.pem -pubout -out feed-signing-public.pem
+
+# Release checksums signing keypair (optional separate key)
+openssl genpkey -algorithm Ed25519 -out release-signing-private.pem
+openssl pkey -in release-signing-private.pem -pubout -out release-signing-public.pem
+```
+
+지문 생성 (표/변경 기록에 있는 상점):
+
+```bash
+openssl pkey -pubin -in feed-signing-public.pem -outform DER | shasum -a 256
+openssl pkey -pubin -in release-signing-public.pem -outform DER | shasum -a 256
+```
+
+발행하기 전에 선택적 테스트 서명:
+
+```bash
+echo '{"probe":"ok"}' > /tmp/probe.json
+openssl pkeyutl -sign -rawin -inkey feed-signing-private.pem -in /tmp/probe.json -out /tmp/probe.sig.bin
+openssl base64 -A -in /tmp/probe.sig.bin -out /tmp/probe.sig
+openssl base64 -d -A -in /tmp/probe.sig -out /tmp/probe.sig.bin
+openssl pkeyutl -verify -rawin -pubin -inkey feed-signing-public.pem -in /tmp/probe.json -sigfile /tmp/probe.sig.bin
+```
+
+# # # # # # # # # # 6) GitHub 비밀 설정
+
+# # # # # # # # # # # 필수 비밀
+
+- `CLAWSEC_SIGNING_PRIVATE_KEY` - PEM-encoded Ed25519 개인 키 (사료 및 릴리스 서명 모두 사용)
+- `CLAWSEC_SIGNING_PRIVATE_KEY_PASSPHRASE` - (옵션) 전용 키가 암호화되는 경우 passphrase
+
+### 절차
+
+1. 명세 **Repo Settings → Secrets and variables → Actions → 새로운 저장소 secret**로 이동하십시오.
+2. header/footer를 포함하여 풀 PEM.
+3. 명세 프리퍼 GitHub **Environment secrets**(필요한 검토자 포함)는 워크플로우 스코핑을 할 수 있습니다.
+4. 명세 기록 교환권:
+- 비밀 이름
+- 제작자
+- 창조 시간
+- 키 지문
+
+# # # # # # # # # # # 권장 환경 보호
+
+- 비밀 서명을 사용할 수있는 워크플로우에 대한 매뉴얼 승인.
+- 보호된 워크플로우를 편집할 수 있는 제한.
+- `main`에 대한 분기 보호 및 워크플로우 변경에 대한 검토가 필요합니다.
+
+# # # # # # # # # # 7) Workflow 통합 점
+
+이 재포는 포스트 mutation로 서명합니다, 사전 발행 통제.
+
+### 피드 파이프
+
+현재 급식 mutation 점:
+- `.github/workflows/poll-nvd-cves.yml`의
+- `.github/workflows/community-advisory.yml`의
+
+현재 행동:
+- 작업 흐름 단계 표지 `advisories/feed.json`로 `advisories/feed.json.sig`
+- 작업 흐름 실행 중에 생성 된 서명을 표시
+- 서명된 artifacts는 PR 자동화를 통해 투입됩니다
+
+# # # # # # # # # # # 페이지 파이프라인
+
+현재 발행인:
+- `.github/workflows/deploy-pages.yml`의
+
+현재 행동:
+- `public/advisories/`에 payload/signature 복사
+- 생성 + `public/checksums.json` 및 `public/checksums.sig` 표지판
+- `public/signing-public.pem` 및 `public/advisories/feed-signing-public.pem`에 서명 키 게시
+- 미러 자문 + 서명 / 체크섬 / 키 동반자 `public/releases/latest/download/` 호환성 경로
+
+# # # # # # # # # # # Skill release 파이프라인 (추천 경화)
+
+현재 방출 발전기:
+- `.github/workflows/skill-release.yml`의
+
+현재 행동:
+- `checksums.json`를 생성하고 `checksums.sig`로 서명하고 게시하기 전에 서명을 검증합니다.
+- 릴리스 자산에 `signing-public.pem` 포함
+- canonical 키 재료에 대한 생성 된 공공 키 지문을 검증
+
+# # # # # # # # # # 8) 교체 정책 및 runbook
+
+### 교체 cadence
+- 루틴: 90 일 (또는 엄격한 org 정책).
+- Immediate: 의심의 여지없이 노출, 무단 작업 흐름 변화, 또는 부정확한 서명 잘못.
+
+### Routine 교체 단계
+
+1. 명세 새로운 keypair(s) 생성.
+2. 명세 공공 키 파일(s) 및 지문 문서를 업데이트하는 PR을 엽니다.
+3. 명세 GitHub secret(s)로 새로운 개인 키 추가
+4. 명세 새로운 키(s)를 사용하는 작업 흐름 변경.
+5. 명세 Re-sign 최신 피드/출판은 나타납니다.
+6. 명세 CI 및 외부 클라이언트의 검증을 검증합니다.
+7. 명세 오래된 개인 키 비밀 제거(s).
+8. 명세 과거의 검증에 필요한 만큼 긴 공공 키 참조를 유지하십시오.
+
+## # 재직 단계
+
+1. 명세 손상된 키를 사용하여 작업 흐름을 비활성화합니다.
+2. 손상된 GitHub 비밀 제거(s).
+3. 명세 재직 및 새로운 공공 키.
+4. 명세 보충 열쇠를 가진 최신 artifacts를 서명하십시오.
+5. 명세 타임스탬프와 충격적인 창을 가진 사건 자문.
+
+# # # # # # # # # # 9) 사용 응답 playbook (signing-specific)
+
+## 트리거
+- 서명 검증은 새로 출판된 Feed/release에 실패합니다.
+- 알 수없는 커밋 / 워크 플로우 편집 경로
+- 유출된 핵심 물자, 사고 로깅, 또는 의심스러운 비밀 접근
+
+## # Severity 가이드
+- **SEV-1**: 키 exfiltration 확인 또는 악성 서명된 페이로드
+- **SEV-2**: 알 수없는 원인과 검증 실패
+- **SEV-3**: 비응축, 활성 타협 없음
+
+# # # # # # # # # # # 응답 단계
+
+1. 명세 **컨테이너* * 이름
+- pause signing/publish 워크플로우
+- 정품이 불확실한 경우 더 많은 피드 합병을 차단
+2. **투자**
+- 검토 워크플로우 실행 로그
+- `.github/workflows/`, `advisories/` 및 키 파일에 영향을 미치는 리뷰 커밋
+- 첫번째 나쁜 타임스탬프 및 영향 받은 artifacts를 결정하십시오
+3. 명세 ** 정보**
+- 회전/복합된 키(s)
+- 알려진 좋은 커밋에서 신뢰할 수있는 artifacts 복원
+4. 명세 ** 복구 **
+- 재 위탁 artifacts
+- Redeploy 페이지/출판
+- 자주 묻는 질문
+5. 명세 ** 우편 번호 * * 이름
+- 간행물 및 구제 요약
+- 조임 컨트롤 (리뷰 게이트, 보호 된 환경, 비밀 범위)
+
+## 10) 감사 증거 체크리스트
+
+각 방출 주기 또는 급식 위탁 달리기를 위해, 유지하십시오:
+- 워크플로우 실행 URL 및 커밋 SHA
+- 사용에 있는 signer 열쇠 지문
+- 검증 결과 로그
+- 연산자/리뷰어 승인
+- 모든 예외 또는 우회 합리적
+
+## 11) 엄격한 정책 변경 전 최소 합격 기준
+
+정책을 더 바짝 죄기 전에 (예를 들어, 호환성 우회 경로 제거):
+- 서명된 artifacts는 적어도 2 주 동안 일관되게 생성합니다
+- 파이프라인 미러 서명 동반자 배치
+- 1개의 rollback 교련 및 1개의 열쇠 교체 교련은 성공적으로 완료했습니다
+- 식별 및 문서화 된 계정 소유자의 사건 응답
+
+## 소스 참조
+- 고문/feed.json
+- 고문/feed.json.sig
+- 고문 / 채권-public.pem
+- clawsec 서명-public.pem
+- .github/actions/sign-and-verify/action.yml
+- .github/workflows/poll-nvd-cves.yml의 경우
+- .github/workflows/community-advisory.yml
+- .github/workflows/deploy-pages.yml의 경우
+- .github/workflows/skill-release.yml의 경우
+- 스크립트/ci/verify_signing_key_consistency.sh
+- 위키/이민 위탁-feed.md
diff --git a/wiki/ko/security.md b/wiki/ko/security.md
new file mode 100644
index 0000000..dc1e73a
--- /dev/null
+++ b/wiki/ko/security.md
@@ -0,0 +1,79 @@
+# Security (한국어)
+
+## 보안 모델 개요
+- ClawSec은 콘텐츠 배포(서명된 아티팩트)와 런타임 동작(advisory gating, 무결성 모니터링)을 모두 보호합니다.
+- 신뢰 앵커는 리포지토리에 고정된 공개 키이며, 워크플로우 산출물과 대조해 검증합니다.
+- 런타임 소비자는 기본적으로 verification-first 동작을 사용하며, 마이그레이션용 bypass 플래그는 명시적으로만 허용됩니다.
+
+## 암호학적 통제
+| 통제 | 메커니즘 | 위치 |
+인포메이션
+| Feed authenticity | Ed25519 detached signatures (`feed.json.sig`) | Advisory 워크플로우 + 소비자 검증 라이브러리 |
+| Artifact integrity | SHA-256 checksum manifests (`checksums.json`) | 스킬 릴리스 및 pages 배포 워크플로우 |
+| Key consistency | 문서/정본 PEM 간 fingerprint 비교 | `scripts/ci/verify_signing_key_consistency.sh` |
+| Signature verification action | CI의 composite sign+verify 액션 | `.github/actions/sign-and-verify/action.yml` |
+
+## 런타임 enforcement 통제
+|제어 | 부품 | 효과 |
+인포메이션
+| Advisory hook gating | `clawsec-advisory-guardian` | 매칭된 advisory 기반 경고 및 보수적 가이드 제공 |
+| Double-confirmation installer | `guarded_skill_install.mjs` | advisory 매칭 시 명시적 확인 전까지 `42`로 종료 |
+| Reputation extension | `clawsec-clawhub-checker` | 설치 전 추가 리스크 스코어링 |
+| NanoClaw signature gate | `skill-signature-handler.ts` + MCP tool | 정책에 따라 변조/미서명 패키지 설치 차단 |
+| Integrity baseline monitor | `soul-guardian` + NanoClaw integrity monitor | drift 탐지, 격리, 복구, 감사 가능한 이력 |
+
+## 공급망 및 CI 통제
+- CI는 Trivy, npm audit, CodeQL, Scorecard 워크플로우를 실행합니다.
+- 로컬 pre-push 점검은 `gitleaks` 설치 시 `gitleaks detect`를 실행할 수 있습니다.
+- 릴리스 워크플로우는 패키징 전에 SBOM 파일 존재를 검증합니다.
+- 배포 워크플로우는 생성된 signing key fingerprint를 정본 키와 대조 검증합니다.
+- 릴리스 문서에는 downstream 소비자를 위한 수동 검증 명령이 포함됩니다.
+
+## 인시던트 및 키 로테이션 플레이북
+- `wiki/security-signing-runbook.md`는 키 생성/보관/로테이션 및 인시던트 단계를 정의합니다.
+- `wiki/migration-signed-feed.md`는 단계적 enforcement 및 rollback 레벨을 정의합니다.
+- 롤백 경로는 가능한 경우 서명된 배포를 유지하고, bypass는 시간 제한 하에 사용하도록 설계됩니다.
+
+## 예시 스니펫
+```bash
+# verify canonical public key fingerprint
+openssl pkey -pubin -in clawsec-signing-public.pem -outform DER | shasum -a 256
+```
+
+```bash
+# run repo key-consistency guardrail used in CI
+./scripts/ci/verify_signing_key_consistency.sh
+```
+
+## 알려진 보안 트레이드오프
+- unsigned 호환 모드는 보증 수준을 낮출 수 있으므로 마이그레이션 완료 후 비활성화해야 합니다.
+- 일부 배포 경로는 하위 호환을 위해 legacy unsigned checksum asset을 허용합니다.
+- 평판 체크는 외부 툴 출력에 의존하므로 휴리스틱 오탐/미탐 가능성이 있습니다.
+- 로컬 스크립트는 실행 환경 신뢰를 상속하므로, 로컬 셸이 손상되면 운영자 워크플로우가 우회될 수 있습니다.
+
+## 하드닝 기회
+- 마이그레이션 안정화 후 unsigned 호환 플래그 제거
+- 미러된 릴리스 파일 전체에 대한 결정론적 checksum/signature 검증 확대
+- 워크플로우 수준 서명 실패 시나리오에 대한 명시적 테스트 추가
+- advisory fetch/verify 실패에 대한 런타임 텔레메트리 강화로 인시던트 트리아지 단순화
+
+## 업데이트 노트
+- 2026-04-27: `wiki/security.md` 한국어 번역 추가.
+- 2026-02-26: signing/migration 참조를 루트 `docs/`에서 `wiki/` 운영 페이지로 재지정.
+
+## 소스 참조
+- `SECURITY.md`
+- `wiki/security-signing-runbook.md`
+- `wiki/migration-signed-feed.md`
+- `scripts/ci/verify_signing_key_consistency.sh`
+- `.github/actions/sign-and-verify/action.yml`
+- `.github/workflows/poll-nvd-cves.yml`
+- `.github/workflows/community-advisory.yml`
+- `.github/workflows/skill-release.yml`
+- `.github/workflows/deploy-pages.yml`
+- `skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs`
+- `skills/clawsec-suite/scripts/guarded_skill_install.mjs`
+- `skills/clawsec-clawhub-checker/scripts/enhanced_guarded_install.mjs`
+- `skills/soul-guardian/scripts/soul_guardian.py`
+- `skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts`
+- `skills/clawsec-nanoclaw/guardian/integrity-monitor.ts`
diff --git a/wiki/ko/testing.md b/wiki/ko/testing.md
new file mode 100644
index 0000000..a4de057
--- /dev/null
+++ b/wiki/ko/testing.md
@@ -0,0 +1,82 @@
+
+
+# 테스트
+
+## 테스트 전략
+- - - 저장소는 단일 루트 `npm test` 명령보다 오히려 계층화 된 검증을 사용합니다.
+- 핵심 신뢰는 lint/type/build 문 플러스 기술 지방에서 옵니다 노드 테스트 스위트.
+- Python 및 shell 툴링은 전용 lint/security 체크를 통해 검증됩니다.
+- Workflow 파이프라인은 로컬 pre-push 자동화에서 사용되는 동일한 명령 클래스를 실행합니다.
+
+## 검증 레이어
+| 층 | 명령 | 범위 |
+인포메이션
+| 프론트엔드/정제 체크 | ESLint + `tsc --noEmit` + `npm run build` | TS/TSX 정정 및 구조의 viability. ·
+| 스킬 유닛 테스트 | `node skills//test/*.test.mjs` | 시그니처, 매칭, 억제, 설치 계약. ·
+| Python 품질 | `ruff check utils/`, `bandit -r utils/ -ll` | 실용신안 및 보안 패턴 ·
+| Shell/script 품질 | ShellCheck + 수동 스크립트 연기 실행 | 스크립트 위생 및 명령 견고함. ·
+| CI 보안 검사 | Trivy, npm Audit, CodeQL, Scorecard | Dependency, config 및 공급망 보안 자세. ·
+| Local pre-push security scan | `gitleaks detect`를 선택하여 `scripts/prepare-to-push.sh` | 푸시하기 전에 비밀 누출 검출. ·
+
+## 기술 테스트 매트릭스
+| 스킬 | 테스트 파일 | 1차 초점 |
+인포메이션
+| `clawsec-suite` | `feed_verification`, `guarded_install`, `path_resolution`, fuzz 테스트 | 시그니처 체크, 자문, 경로 안전, 매칭 내구성. ·
+| `openclaw-audit-watchdog` | 억제 구성 및 렌더링 테스트 | Config 패싱, 억제 행동, 보고 포맷. ·
+| `clawsec-clawhub-checker` | `reputation_check.test.mjs` | 입력 유효성 및 평판조절 행동 ·
+
+## CI 워크 플로우 적용
+| 워크 플로우 | 트리거 | 키 보조 ·
+인포메이션
+| `ci.yml` | `main` PR/push | Lint/type/build, Python 검사, 보안 검사, 기술 테스트. ·
+| `codeql.yml` | PR/push/schedule | JS/TS 정적 보안 분석 ·
+| `scorecard.yml` | 시간표/푸시 | 공급망 보고 및 SARIF 업로드. ·
+| `skill-release.yml` | 태그 + PR | 버전 패리티 및 릴리스 artifact 검증. ·
+
+## 로컬 테스트 명령
+```bash
+# baseline frontend + config checks
+npx eslint . --ext .ts,.tsx,.js,.jsx,.mjs --max-warnings 0
+npx tsc --noEmit
+npm run build
+```
+
+```bash
+# representative skill tests
+node skills/clawsec-suite/test/feed_verification.test.mjs
+node skills/clawsec-suite/test/guarded_install.test.mjs
+node skills/openclaw-audit-watchdog/test/suppression_config.test.mjs
+```
+
+## 실패 패턴
+- 시그니처/테스트 정착물은 예상된 파일이 불행히도 재화될 때 열쇠/payload mismatch에서 실패할 수 있습니다.
+- Path-resolution 테스트 의도적으로 탈출 된 홈 토큰에 실패; 이 행동은 예상되고 보안 위험.
+- `openclaw` 또는 `clawhub` binaries에 의존하는 로컬 스크립트는 해당 CLI가 복종되는 환경에서 실패할 수 있습니다.
+- Deploy/release logic은 비밀이나 워크플로우 권한이 다를 경우 CI에서 실패하면서 로컬로 전달할 수 있습니다.
+
+## 건의된 시험 순서
+1. 가득 차있는 국부적으로 문을 위한 `./scripts/prepare-to-push.sh`를 실행하십시오.
+2. 명세 직접 기술 로컬 테스트에 영향을 미칩니다.
+3. 명세 피드 / 서명 변경을 위해, 스위트 검증 테스트를 실행 (`feed_verification`, `guarded_install`).
+4. 명세 워크플로우 또는 릴리즈 변경을 위해 `scripts/validate-release-links.sh` 및 키 일관성 스크립트를 실행합니다.
+
+## 업데이트 노트
+- 2026-02-26 : `wiki/platform-verification.md` 체크리스트에 업데이트 된 소스 참조.
+
+## 소스 참조
+- 아젠츠.md
+- 스크립트/prepare-to-push.sh
+- 스크립트/validate-release-links.sh
+- .github/workflows/ci.yml의 경우
+- .github/workflows/codeql.yml의
+- .github/workflows/scorecard.yml의 경우
+- .github/workflows/skill-release.yml의 경우
+- 기술/하프스위트/테스트/feed_verification.test.mjs
+- 기술/클래스/테스트/guarded_install.test.mjs
+- 기술/클래스/테스트/path_resolution.test.mjs
+- 기술/openclaw-audit-watchdog/test/suppression_config.test.mjs
+- 기술/클로슈-클로브 검사기/테스트/reputation_check.test.mjs
+- 위키/platform-verification.md
diff --git a/wiki/ko/workflow.md b/wiki/ko/workflow.md
new file mode 100644
index 0000000..1440518
--- /dev/null
+++ b/wiki/ko/workflow.md
@@ -0,0 +1,87 @@
+
+
+# 작업 흐름
+
+## 엔드 투 엔드 라이프 사이클
+- 개발은 로컬 코딩 + 실시간 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/`를 `.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
diff --git a/wiki/localization.md b/wiki/localization.md
new file mode 100644
index 0000000..2bfe833
--- /dev/null
+++ b/wiki/localization.md
@@ -0,0 +1,71 @@
+# Localization Workflow
+
+## Purpose
+Define a repeatable docs localization pipeline for ClawSec README and wiki pages.
+
+## Scope
+- Source language: English (`README.md`, `wiki/*.md`)
+- Current translated language: Spanish (`README.es.md`, `wiki/es/*.md`)
+- Korean pilot language: Korean (`README.ko.md`, `wiki/ko/*.md`)
+- Future languages: `wiki//...` and `README..md`
+
+## Source of Truth Rules
+1. English files are canonical.
+2. Translations must preserve commands, file paths, code blocks, and identifiers exactly.
+3. Product names and skill names stay untranslated (`ClawSec`, `OpenClaw`, `NanoClaw`, `Hermes`, `Picoclaw`, skill package names).
+4. When translation coverage is partial, translated files must state scope explicitly.
+
+## Folder Conventions
+- README translations:
+ - `README.es.md`
+ - Future: `README.fr.md`, `README.de.md`, `README.ja.md`, etc.
+- Wiki translations:
+ - `wiki/es/INDEX.md`
+ - `wiki/es/.md`
+ - Future: `wiki/fr/.md`, `wiki/de/.md`, etc.
+- Localization assets:
+ - `wiki/i18n/terminology-en-es.md`
+ - `wiki/i18n/translation-tracker.md`
+
+## Update Workflow
+1. **Normalize source docs first**
+ - Update English source docs for clarity and structure before translation.
+2. **Record delta**
+ - Note changed English pages in `wiki/i18n/translation-tracker.md`.
+3. **Scaffold missing pages (loop/script)**
+ - Dry-run: `python scripts/i18n/bootstrap_language_from_en.py --lang --dry-run`
+ - Apply: `python scripts/i18n/bootstrap_language_from_en.py --lang `
+ - Optional overwrite: `python scripts/i18n/bootstrap_language_from_en.py --lang --overwrite`
+ - Convenience scripts: `npm run i18n:bootstrap:ko|fr|de|ja`
+4. **Translate changed pages**
+ - Preserve markdown structure and heading levels.
+ - Keep command blocks untouched.
+5. **QA pass**
+ - Verify links resolve.
+ - Verify code blocks and inline commands are unchanged.
+ - Verify terminology consistency using `terminology-en-es.md`.
+6. **Regenerate exports**
+ - Run `npm run gen:wiki-llms`.
+7. **Review and PR**
+ - Include summary of translated pages and remaining gaps.
+
+## Translation QA Checklist
+- [ ] Heading hierarchy preserved.
+- [ ] Command snippets unchanged and runnable.
+- [ ] File paths and URLs unchanged.
+- [ ] Skill and platform names unchanged.
+- [ ] Security terminology consistent.
+- [ ] `wiki/INDEX.md` has translation link entries.
+- [ ] `wiki//INDEX.md` links back to key English pages when untranslated.
+
+## Suggested Language Rollout
+1. Spanish (`es`) – done in phase 1 baseline.
+2. French (`fr`) and German (`de`) for broad technical audience.
+3. Japanese (`ja`) for high-fidelity platform docs.
+
+## Source References
+- README.md
+- README.es.md
+- wiki/INDEX.md
+- wiki/es/INDEX.md
+- wiki/es/overview.md