polish-claw-project
About
This Claude Skill provides a structured 9-step workflow for contributing to OpenClaw ecosystem projects. It guides developers through target verification, codebase exploration, parallel auditing, and pull request creation, emphasizing false positive prevention and convention adherence. Use it for systematic, repeatable contributions to OpenClaw, NemoClaw, or NanoClaw repositories.
Quick Install
Claude Code
Recommendednpx 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-projectCopy and paste this command in Claude Code to install this skill
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 — 提程
GitHub Repository
Related Skills
content-collections
MetaThis skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.
polymarket
MetaThis skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.
creating-opencode-plugins
MetaThis skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.
sglang
MetaSGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.
