polish-claw-project
À propos
Cette Skill Claude propose un processus structuré en 9 étapes pour contribuer aux projets de l'écosystème OpenClaw. Elle guide les développeurs à travers la vérification de la cible, l'exploration du codebase, l'audit parallèle et la création de pull requests, en mettant l'accent sur la prévention des faux positifs et le respect des conventions. Utilisez-la pour des contributions systématiques et reproductibles aux dépôts OpenClaw, NemoClaw ou NanoClaw.
Installation rapide
Claude Code
Recommandénpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/polish-claw-projectCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
磨爪案
九步構獻 OpenClaw 生案:標驗、碼探、並審、果交對、PR 立。新值在步五至七。機械步(叉、PR 立)委於現技。
用
- 獻 NVIDIA/OpenClaw、NVIDIA/NemoClaw、NVIDIA/NanoClaw 或類爪生庫→用
- 首獻陌生安敏架之開源→用
- 求可重審之獻程非隨修→用
- 已識爪案受外獻(察 CONTRIBUTING.md)→用
入
- 必:
repo_url— 標爪案 GitHub URL(如https://github.com/NVIDIA/NemoClaw) - 可:
contribution_count— 目獻數(默 1-3)focus— 偏獻型:security、tests、docs、bugs、any(默any)fork_org— 叉入 GitHub 組/用(默認證用)
行
一:識驗標
確案受外獻、活養。
- 開庫 URL 讀
CONTRIBUTING.md、CODE_OF_CONDUCT.md、LICENSE - 察近提(末 30 日)與開 PR 合率
- 驗案用寬或獻友證
- 讀
SECURITY.md或安策若有——注責披則 - 識主語、試框、CI 系
得:CONTRIBUTING.md 在、提於末 30 日、明獻引。
敗:無 CONTRIBUTING.md 或近活→記由止——陳案少合外 PR。
二:叉並複
立庫工本。
- 叉:
gh repo fork <repo_url> --clone - 設上游:
git remote add upstream <repo_url> - 驗:
git remote -v示origin(叉)與upstream - 同:
git fetch upstream && git checkout main && git merge upstream/main
得:地複含二遠設且新。
敗:叉敗→察 GitHub 認(gh auth status)。複緩→試 --depth=1 為初探。
三:探碼
建案構心模。
- 讀
README.md為架覽與案標 - 識入點、核模、公 API 面
- 映試構:試在何、用何框、覆級
- 注碼風俗:linter 配、命名式、入順
- 察 Docker/容器、CI 配、布式
得:明案構、俗、獻何處可入。
敗:架不明→聚於某子系非全案。
四:讀開事
察現事以解案需、避重工。
- 列開事:
gh issue list --state open --limit 50 - 按型別:錯、功、文、安、good-first-issue
- 注標
help wanted、good first issue、hacktoberfest之事 - 察陳事(>90 日開、無近註)——恐已棄
- 讀連 PR 以解嘗試
得:分類未領事列含型標。
敗:無開事→赴步五——審恐發未列改。
五:並審
並行安與碼質審。新發於此。
- 對案根行
security-audit-codebase技 - 同行
review-codebase技範quality - 要:對案威脅模與架驗各發
- 沙箱啟引中之「硬編密」非漏
- 內函缺入驗為低重
- 標漏依恐已為案架緩
- 評驗發:CRITICAL、HIGH、MEDIUM、LOW
- 假陽含理由記——其入未來 Common Pitfalls
得:驗發列含重評與假陽注。
敗:無發→轉聚於試覆缺、文改、開驗增。
六:交對發
映驗審發於開事——核斷步。
- 各驗發、搜開事為相討
- 各發歸:
- 配開事——連發於事
- 新發——無現事覆
- 已修於 PR——察開 PR 為進中修
- 序配現事之發(合率最高)
- 新發:按案先察養者受否
得:序列含發-事映與合率評。
敗:諸發皆已處→返步四覓文、試、開驗獻。
七:擇獻
按效、力、專擇 1-3 獻。
- 各候評於:
- 效:此進案幾何?(安 > 錯 > 試 > 文)
- 力:聚會內可善成乎?(宜小完 PR)
- 專:獻者有此修域知乎?
- 合率:合案述先乎?
- 擇高者(默 1-3)
- 各定:枝名、範界、受則、試計
得:1-3 擇獻含明範與受則。
敗:無獻評高→計提善書事代 PR。
八:實
各獻立枝、實修。
- 各獻:
git checkout -b fix/<description> - 嚴遵案俗(linter、命名、入順)
- 加更涵變之試
- 行案試套:諸試過
- 行案 linter:無新警
- 各 PR 聚——一邏變一枝
得:清實含過試、無 linter 警。
敗:試於先存事敗→記之、確 PR 不引新敗。
九:立 PR
按案 CONTRIBUTING.md 提獻。
- 推枝:
git push origin fix/<description> - 用
create-pull-request技立 PR - PR 體引相事(如「Fixes #123」)
- 遵案 PR 模若有
- 速應審饋——速迭
得:PR 立、連事、遵案俗。
敗:PR 立敗→察枝護則與獻者證約。
驗
- 諸擇獻已實提為 PR
- 各 PR 引相事(若有)
- 諸案試於各 PR 枝過
- 無假陽提為實事
- PR 述遵案 CONTRIBUTING.md 模
忌
- 假陽過稱:爪案用沙箱架——沙箱內「漏」恐為設。報前必對案威脅模驗
- 摘要/簽鏈擾:爪案常用驗鏈為模整。變必保此鏈否則 PR 拒
- 俗錯:爪案嚴行風。行案自身 linter、非通。配入順、文串式、試式精確
- 範蔓:3 聚 PR 速合於 1 蔓 PR。各獻原子
- 陳叉:始工前必同上游(
git fetch upstream && git merge upstream/main)
參
- security-audit-codebase — 步五安發
- review-codebase — 步五碼質察
- create-pull-request — 步九 PR 立
- create-github-issues — 為非 PR 處之發提事
- manage-git-branches — 實時枝管
- commit-changes — 提程
Dépôt GitHub
Compétences associées
content-collections
MétaCette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.
polymarket
MétaCette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.
creating-opencode-plugins
MétaCette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.
sglang
MétaSGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.
