mirror of https://github.com/prompt-security/clawsec.git synced 2026-06-13 05:28:02 +03:00

Files

T

David Abutbul b37162a33d feat(i18n): add multilingual wiki scaffolding, language switcher, and… (#212 )

* feat(i18n): add multilingual wiki scaffolding, language switcher, and translation QA pipeline

* docs(readme): adopt picoclaw-style multilingual link bar

* fix(i18n): repair localized index links and tighten partial-pair QA

* ci(i18n): fail on broken markdown links in README/wiki

* ci(i18n): add changed-files mode for markdown link checks

* i18n(de): use local Argos MT to fill untranslated German sections

* i18n(es,fr): fill untranslated sections via local Argos workflow

* i18n(ja): fill untranslated sections with scoped local Argos pass

* i18n(ko): fill untranslated sections with scoped local Argos pass

* fix(i18n): address review feedback

---------

Co-authored-by: David Abutbul <David.a@prompt.security>

2026-04-29 09:00:31 +03:00

9.1 KiB

Raw Blame History

建築

システムコンテキスト

- - このページは、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 | スキルメタデータ検証とチェックサム生成お問い合わせ

ツイートキーフロー

スキルカタログの流れ:

スキルアセットを公開するワークフローのリリース/タグ 2。ワークフローを展開すると、リリースアセットが発見され、public/skills/index.jsonが構築されます。
/skillsのページのpublic/skills/index.jsonとスキルドキュメントのUIフェッチ。

アドバイザリーフィードフロー:

poll-nvd-cves.ymlおよびcommunity-advisory.ymlの更新advisories/feed.json。
飼料は署名され、公道に映ります。
Runtime hooks/scripts はローカル署名されたコピーにリモートフィードとフォールバックをロードします。

ガードされた取付けの流れ: 1。インストーラ要求の対象スキル+バージョン。

アドバイザリー・マッチダーは影響を受けた分光器および重度/リスクヒントを点検します。
終了コード42は、アドバイザリーが一致したときに2番目の確認を実施します。

##ダイアグラム

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) | ランタイムハンドラは、選択したイベント名だけを処理します。お問い合わせ | ワークフローリリース命名 | タグパターン <skill>-vX.Y.Z | リリース・デメリットのワークフローで解析し、スキルを身につけるお問い合わせ

エラー処理と信頼性

フィードのフェッチングは、無効なシグネチャとmalformedマニフェストのために不閉鎖されます。
遠隔フェッチの失敗はローカル署名された供給に優雅に落ちます。
ホックの状態は支えられる厳密なモードと原子ファイル書き込みを使用します。
UIページでは、HTMLフォールバックがJSONとして機能し、破損したデータをレンダリングすることを避けます。
ワークフロー手順は、キーフィンガープリントの一貫性を強化し、スプリットキードリフトを回避します。

サンプルスニペット

// Route topology in the web app
<Routes>
  <Route path="/" element={<Home />} />
  <Route path="/skills" element={<SkillsCatalog />} />
  <Route path="/skills/:skillId" element={<SkillDetail />} />
  <Route path="/feed" element={<FeedSetup />} />
  <Route path="/feed/:advisoryId" element={<AdvisoryDetail />} />
  <Route path="/wiki/*" element={<WikiBrowser />} />
</Routes>

// Guarded feed loading contract in advisory hook
const remoteFeed = await loadRemoteFeed(feedUrl, {
  signatureUrl: feedSignatureUrl,
  checksumsUrl: feedChecksumsUrl,
  checksumsSignatureUrl: feedChecksumsSignatureUrl,
  publicKeyPem,
  checksumsPublicKeyPem: publicKeyPem,
  allowUnsigned,
  verifyChecksumManifest,
});

実行時間と展開

##スケーリングノート

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

9.1 KiB Raw Blame History

建築