Agent Skillsalinaqi/maggy › council-review

council-review

GitHub

多模型验证技能,通过专家委员会自动审查计划、架构变更和PR。配置阈值与评审员,确保关键决策在执行前获得独立验证,提升代码质量与系统安全性。

skills/council-review/SKILL.md alinaqi/maggy

Trigger Scenarios

编写计划文件时 进行架构变更时 标记PR完成前

Install

npx skills add alinaqi/maggy --skill council-review -g -y
More Options

Use without installing

npx skills use alinaqi/maggy@council-review

指定 Agent (Claude Code)

npx skills add alinaqi/maggy --skill council-review -a claude-code -g -y

安装 repo 全部 skill

npx skills add alinaqi/maggy --all -g -y

预览 repo 内 skill

npx skills add alinaqi/maggy --list

SKILL.md

Frontmatter
{
    "name": "council-review",
    "effort": "high",
    "description": "Multi-model validation council — auto-validate plans, architecture changes, and PRs via validate-plan\/review before executing",
    "when-to-use": "When you write a plan to ~\/.claude\/plans\/, make architectural changes, or before marking a PR done; required for CLAUDE-tier tasks",
    "allowed-tools": [
        "Bash",
        "Read"
    ],
    "user-invocable": false
}

Council of Experts — Multi-Model Validation

When to Auto-Trigger

Plans (auto_validate_plans)

When you write a plan to ~/.claude/plans/, automatically validate it:

~/bin/validate-plan --threshold 2 ~/.claude/plans/<plan-file>.md
  • 2+ of 3 approve → execute immediately
  • 1 of 3 → surface reviewer feedback to user before proceeding
  • 0 of 3 → revise plan, re-validate

Architecture Decisions (auto_review_architecture)

When making architectural changes (new services, API redesigns, database schema changes), run:

~/bin/review --all "Review this architecture: <summary>"

PR Review (auto_review_prs)

Before marking a PR as done, run:

~/bin/review --all --file <changed-files>

Configuration

Council behavior is configured in ~/.claude/council.yaml. The Maggy dashboard (Settings > Council) also manages this config.

Chief of the Council

chief: claude-fable-5 — Claude Fable 5 (Anthropic's most capable widely-released model, GA 2026-06-09) leads every panel as the chief: it reviews first and casts the deciding synthesis. Invoked via ~/bin/claude-fable-5. Override the chief in ~/.claude/council.yaml.

Reviewer Contexts

The chief leads each context, followed by the panel:

Context Default Reviewers When
plan Claude Fable 5 (chief), DeepSeek Pro, Codex, Gemini Pro Before executing any plan
review Claude Fable 5 (chief), DeepSeek Pro, Kimi Code review, PR review
architecture Claude Fable 5 (chief), DeepSeek Pro, Gemini Pro, Grok System design, schema changes

Threshold Rules

The threshold setting controls how many approvals are needed:

  • threshold: 2 with 3 reviewers → need 2/3 to auto-execute
  • Clamped to [1, reviewer_count] — can't be 0 or exceed available reviewers

Model Inventory

All 13 tiers are listed in ~/.claude/council.yaml under models:. Each has:

  • id — unique identifier
  • cmd — CLI command to invoke (null for Claude models, which are the host)
  • tier — routing priority (0=cheapest, 12=most capable)
  • label — human-readable name

Use POST /api/models/health to verify all models are responding.

How This Skill is Used

This skill is loaded by Claude Code on session start. It provides the behavioral rules for when to invoke multi-model validation. The actual execution happens via ~/bin/validate-plan and ~/bin/review which are already installed.

Do not skip council validation for CLAUDE-tier tasks. The whole point is that architecture and security decisions get independent verification before execution.

Version History

  • bb6195f Current 2026-07-25 07:42

Same Skill Collection

skills/aeo-optimization/SKILL.md
skills/agent-teams/SKILL.md
skills/agentic-development/SKILL.md
skills/ai-models/SKILL.md
skills/android-java/SKILL.md
skills/android-kotlin/SKILL.md
skills/aws-aurora/SKILL.md
skills/aws-dynamodb/SKILL.md
skills/azure-cosmosdb/SKILL.md
skills/base/SKILL.md
skills/cloudflare-d1/SKILL.md
skills/code-deduplication/SKILL.md
skills/code-graph/SKILL.md
skills/codex-review/SKILL.md
skills/commit-hygiene/SKILL.md
skills/cpg-analysis/SKILL.md
skills/cross-agent-delegation/SKILL.md
skills/database-schema/SKILL.md
skills/existing-repo/SKILL.md
skills/firebase/SKILL.md
skills/flutter/SKILL.md
skills/gemini-review/SKILL.md
skills/icpg/SKILL.md
skills/iterative-development/SKILL.md
skills/klaviyo/SKILL.md
skills/llm-patterns/SKILL.md
skills/maggy/SKILL.md
skills/medusa/SKILL.md
skills/mnemos/SKILL.md
skills/ms-teams-apps/SKILL.md
skills/nodejs-backend/SKILL.md
skills/playwright-testing/SKILL.md
skills/polyphony/SKILL.md
skills/project-tooling/SKILL.md
skills/pwa-development/SKILL.md
skills/python/SKILL.md
skills/react-native/SKILL.md
skills/react-web/SKILL.md
skills/reddit-api/SKILL.md
skills/session-management/SKILL.md
skills/shopify-apps/SKILL.md
skills/site-architecture/SKILL.md
skills/supabase/SKILL.md
skills/team-coordination/SKILL.md
skills/ticket-craft/SKILL.md
skills/ui-mobile/SKILL.md
skills/ui-testing/SKILL.md
skills/ui-web/SKILL.md
skills/user-journeys/SKILL.md

Metadata

Files
0
Version
abc600e
Hash
326af45b
Indexed
2026-07-25 07:42

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-20 14:51
浙ICP备14020137号-1 $방문자$