菜单
When and how to evolve .coderabbit.yaml — enable new tools, switch profile, add path-instructions for new doc subtrees, tune tone. Triggers: update coderabbit config, tune cr, edit coderabbit yaml.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
End-to-end PR loop. Opens PR, waits CI, waits CodeRabbit, triages, fixes, replies, resolves, re-runs CI, merges. The mastermind invokes this and walks away. Triggers: babysit pr, drive pr, ship pr end to end.
Branch naming, base branch, draft policy, auto-merge policy, force-push policy. Short, table-driven. Triggers: branch naming, branch policy, where to branch from.
Post threaded replies to CodeRabbit review threads via GraphQL addPullRequestReviewThreadReply (or REST fallback). For wrong/opinion threads include principle citation. Triggers: reply coderabbit, post cr reply.
Mark review threads resolved via GraphQL resolveReviewThread mutation. Paginated, dry-run, batch. REST cannot do this. Triggers: resolve cr threads, mark resolved, close review threads.
Fetch all coderabbitai[bot] review threads via GraphQL, classify each (bug/nit/suggestion/opinion/wrong), emit accept/reject/discuss plan. Triggers: triage coderabbit, classify cr comments, cr plan.
For each accepted CR thread, locate file, route to right subagent, apply fix, build, run scoped tests, push, then resolve threads. Triggers: fix cr, apply coderabbit, address review comments.
| name | coderabbit-config |
| description | When and how to evolve .coderabbit.yaml — enable new tools, switch profile, add path-instructions for new doc subtrees, tune tone. Triggers: update coderabbit config, tune cr, edit coderabbit yaml. |
Single file: /home/superuser/workspace/sebyx07/nexus-engine/.coderabbit.yaml. Schema: https://coderabbit.ai/integrations/schema.v2.json.
| Trigger | Edit |
|---|---|
| New language/runtime in repo | add reviews.tools.<linter>: enabled: true |
New doc subtree under docs/<x>/ | add path_instructions entry |
New crate subtree under crates/<x>/ | add path_instructions entry |
| Too many noisy nits | switch profile: assertive → chill (last resort) |
| Too few catches | switch profile: chill → assertive (default) |
New principle added to docs/architecture/01-principles.md | append rule to tone_instructions |
| New file glob to exclude | path_filters add !<glob> |
| Tone shift (e.g., new house rule) | edit tone_instructions |
| Profile | Behavior |
|---|---|
assertive (default) | flags more, asks for changes, blocks merge until addressed |
chill | summary only, no block, fewer nits |
Nexus default: assertive. Law 2 (spec-before-code) is too important to relax.
- path: "crates/<new>/**/*.rs"
instructions: |
Enforce Nexus principles (docs/architecture/01-principles.md).
- No unwrap/expect/panic outside #[cfg(test)] (Law 6, 10)
- Structured errors via thiserror (Law 10)
- #[deny(missing_docs)] on all public items
- tests live next to code in `#[cfg(test)] mod tests`
Cite the spec in commit message: `docs/specs/<system>/<file>.md`.
| Tool | Nexus default | Why |
|---|---|---|
shellcheck | on | shell scripts in scripts/, .github/workflows/ |
markdownlint | on | spec/contract/guide quality |
github-checks | on, timeout 900000 | wait for CI before final review |
gitleaks | on | Law 7-adjacent: no secrets ever |
actionlint | on | GitHub Actions correctness |
yamllint | on | configs |
hadolint | on | Dockerfiles for nexus run --container |
biome | on | TS/JS in crates/scripting/ts-bindings/, web tooling |
ruff | on | Python in tools/, nexus-agent-sdk/python/ |
checkov | on if infra/ exists | IaC for matchmaking/relay |
sqlfluff | on if migrations/ exists | currently no SQL |
prisma-lint | off | no Prisma usage |
ktlint | off | no Kotlin |
ruby/rubocop | off | no Ruby |
reviews:
tools:
<tool>:
enabled: true
# optional: config_file: ".<tool>.yml"
Commit: chore(coderabbit): enable <tool> for <reason>.
reviews:
path_instructions:
- path: "<glob>"
instructions: |
<rules — one per line, imperative>
Reference: docs/<...>
Commit: chore(coderabbit): add path_instruction for <path>.
npx -y @stoplight/spectral-cli lint .coderabbit.yaml --ruleset https://coderabbit.ai/integrations/schema.v2.json (best-effort).git diff .coderabbit.yaml # review
gh pr comment "$PR" --body "@coderabbitai full review" # on next PR, force fresh review
docs/guides/coderabbit.md — narrative companiondocs/architecture/01-principles.md