Repository navigation
chore(skills): add run-autonomous-github-agent skill + driver - #366
Conversation
driver.sh owns venv (outside repo), clean cwd (placeholder .env breaks pydantic-settings), and env (gh token, dummy LLM key). Covers CLI, MCP stdio (mcp_client.py, mcp<2), risk scorer, .github/scripts, overseer, autopilot, and pytest. All documented commands verified locally. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
✅ Quality Ratchet — PASSEDNo new ruff violations introduced by this PR. 🎉 |
📊 Code Complexity AnalysisSummary:
|
| File | Function | Complexity | Line |
|---|---|---|---|
core/risk_scorer.py |
score_pull_request |
35 | 141 |
autopilot/autopilot.py |
generate_summary |
24 | 195 |
.github/scripts/inline_pr_commenter.py |
_is_likely_safe_b608 |
19 | 252 |
.github/scripts/threshold_monitor.py |
_is_likely_safe_b608 |
19 | 169 |
autopilot/staleness_engine.py |
process_stale_prs |
16 | 281 |
autopilot/ai_optimization/performance_monitor.py |
get_benchmark_stats |
15 | 184 |
.github/scripts/weekly_digest.py |
build_blocks |
15 | 38 |
.github/scripts/batch_scan_dependabot.py |
main |
15 | 64 |
.github/scripts/prometheus_exporter.py |
collect_metrics |
14 | 99 |
.github/scripts/self_healing_system.py |
analyze_failure_patterns |
14 | 256 |
... and 21 more
Recommendations:
- Break down large functions into smaller, focused units
- Extract complex conditional logic into separate functions
- Use early returns to reduce nesting
🔧 Low Maintainability Files
These files have low maintainability scores and may need refactoring:
| File | Score | Status |
|---|---|---|
.github/scripts/health_dashboard_generator.py |
28.14 | 🔴 |
.github/scripts/threshold_monitor.py |
32.4 | 🔴 |
.github/scripts/workflow_monitor.py |
33.73 | 🔴 |
.github/scripts/ai_code_suggestor.py |
33.76 | 🔴 |
.github/scripts/ai_workflow_optimizer.py |
35.51 | 🔴 |
.github/scripts/inline_pr_commenter.py |
35.51 | 🔴 |
.github/scripts/performance_benchmark.py |
39.46 | 🔴 |
.github/scripts/self_healing_system.py |
40.27 | 🔴 |
.github/scripts/parallel_code_analyzer_optimized.py |
41.16 | 🔴 |
autopilot/tests/test_recommendation_contract.py |
42.05 | 🔴 |
autopilot/autopilot.py |
42.45 | 🔴 |
autopilot/ai_optimization/anomaly_detector.py |
42.56 | 🔴 |
.github/scripts/refactoring_assistant.py |
43.03 | 🔴 |
autopilot/ai_optimization/intelligent_cache.py |
43.28 | 🔴 |
autopilot/ai_optimization/commit_summarizer.py |
44.05 | 🔴 |
.github/scripts/async_parallel_analyzer.py |
44.47 | 🔴 |
autopilot/ai_optimization/performance_monitor.py |
44.69 | 🔴 |
.github/scripts/badge_generator.py |
45.28 | 🔴 |
.github/scripts/copilot_integration.py |
45.37 | 🔴 |
.github/scripts/distributed_monitoring.py |
45.53 | 🔴 |
autopilot/dependency_graph.py |
45.65 | 🔴 |
.github/scripts/elite_copilot.py |
45.69 | 🔴 |
.github/scripts/issue_auto_creator.py |
46.39 | 🔴 |
.github/scripts/cost_calculator.py |
46.4 | 🔴 |
.github/scripts/complexity_reporter.py |
46.78 | 🔴 |
.github/scripts/pr_triage.py |
47.13 | 🔴 |
core/risk_scorer.py |
48.15 | 🔴 |
autopilot/ai_optimization/nlp_relevance_filter.py |
48.43 | 🔴 |
.github/scripts/pr_inline_commenter.py |
48.47 | 🔴 |
.github/scripts/dependency_audit.py |
48.7 | 🔴 |
autopilot/staleness_engine.py |
48.73 | 🔴 |
.github/scripts/dependency_updater.py |
48.91 | 🔴 |
.github/scripts/metrics_collector.py |
48.91 | 🔴 |
autopilot/ai_optimization/ml_priority_scorer.py |
49.53 | 🔴 |
.github/scripts/parallel_code_analyzer.py |
49.96 | 🔴 |
autopilot/ai_optimization/api_optimizer.py |
50.46 | 🟡 |
autopilot/recommendation_contract.py |
51.32 | 🟡 |
.github/scripts/workflow_optimizer.py |
51.67 | 🟡 |
.github/scripts/cot_selector.py |
51.73 | 🟡 |
.github/scripts/release_manager.py |
51.92 | 🟡 |
.github/scripts/check_quality.py |
52.33 | 🟡 |
.github/scripts/auto_pr.py |
52.72 | 🟡 |
.github/scripts/changelog_generator.py |
53.13 | 🟡 |
.github/scripts/notification_manager.py |
53.58 | 🟡 |
.github/scripts/prometheus_exporter.py |
54.96 | 🟡 |
.github/scripts/weekly_digest.py |
55.02 | 🟡 |
core/audit_logger.py |
55.6 | 🟡 |
.github/scripts/llm_router.py |
55.85 | 🟡 |
.github/scripts/batch_scan_dependabot.py |
56.3 | 🟡 |
core/llm_provider.py |
56.32 | 🟡 |
autopilot/decisions/ledger.py |
56.33 | 🟡 |
.github/scripts/streaming_results.py |
56.64 | 🟡 |
.github/scripts/setup_branch_protection.py |
57.0 | 🟡 |
.github/scripts/gather_context.py |
57.53 | 🟡 |
.github/scripts/optimized_github_client.py |
58.27 | 🟡 |
agents/orchestrator_agent.py |
59.02 | 🟡 |
core/incident_freeze.py |
59.67 | 🟡 |
core/github_client.py |
61.96 | 🟡 |
core/message_queue.py |
63.22 | 🟡 |
core/agent_config.py |
63.82 | 🟡 |
core/idempotency.py |
64.45 | 🟡 |
Maintainability Index Guide:
- 🟢 85-100: Excellent maintainability
- 🟡 65-84: Good maintainability
- 🟠 50-64: Moderate maintainability (consider refactoring)
- 🔴 0-49: Poor maintainability (needs refactoring)
🟢 Risk Assessment: LOW (2.5/10)Analysed 3 files, 275+ / 0− lines. Test coverage unchanged or improved. Scoring breakdown
|
🤖 Elite AI Copilot AnalysisElite AI Copilot Analysis ReportGenerated: 2026-10-22 06:15:36 🎯 Health Score: 100.0/100🚀 Top Recommendations
📊 Detailed InsightsCode Quality Baseline Established
Security Scan Initiated
Repository Structure Analyzed
Performance Baseline Captured
Documentation Structure Good
Powered by Elite AI Copilot v1.0 |
Code Quality Analysis ❌ FAILEDDuration: 0.02s Tool Results
View detailed results{
"timestamp": "2026-10-22 06:15:38",
"elapsed_seconds": 0.02,
"summary": {
"total_issues": 10,
"critical": 0,
"high": 0,
"medium": 0,
"low": 0
},
"tools": {
"pylint": {
"status": "failed",
"output": "",
"errors": "Pylint error: [Errno 2] No such file or directory: 'pylint'"
},
"flake8": {
"status": "failed",
"output": "",
"errors": "Flake8 error: [Errno 2] No such file or directory: 'flake8'"
},
"bandit": {
"status": "failed",
"output": "",
"errors": "Bandit error: [Errno 2] No such file or directory: 'bandit'"
},
"radon_cc": {
"status": "failed",
"output": "",
"errors": "Radon error: [Errno 2] No such file or directory: 'radon'"
},
"radon_mi": {
"status": "failed",
"output": "",
"errors": "Radon MI error: [Errno 2] No such file or directory: 'radon'"
}
},
"passed": false
} |
🔒 Security Scan Results🛡️ Bandit Security Scan
📦 Dependency Vulnerabilities
Vulnerable Dependencies:
Security scans run automatically on every PR. View detailed reports in the Actions tab. |
🔍 Pre-commit Checks✅ All pre-commit checks passed! Your code follows the project style guidelines. Pre-commit hooks help maintain code quality and consistency. |
🤖 DRC Agent AnalysisRecommendation: 🟠 P1 IMPORTANT Summary: Solution 2 (Skill + Validation Harness) as recommended by REALIST, with registry.json stub from Solution 3 as a forward-compatibility hook Next steps:
Strategic fit: Consulting: high · Product: medium · Tech debt: reduces Analysed by GadgetLab DRC Agent (Dreamer → Realist → Critic) · Run |
There was a problem hiding this comment.
🟡 Changes recommended
MCP commands depend on a missing server, and the report wrappers silently override explicit --output=path destinations.
2 open issues
What changed in this PR
Adds a Claude Code skill and local tooling for driving the existing agent entry points without changing runtime code or workflows.
Changes:
- Documents local commands, prerequisites, safety limits, and troubleshooting.
- Adds a shell driver for environment setup and command dispatch.
- Adds a minimal MCP stdio client for listing and calling tools.
| File | Description |
|---|---|
.claude/skills/run-autonomous-github-agent/SKILL.md |
Documents local execution and troubleshooting. |
.claude/skills/run-autonomous-github-agent/mcp_client.py |
Provides MCP stdio tool invocation. |
.claude/skills/run-autonomous-github-agent/driver.sh |
Manages setup and wraps local entry points. |
Review effort: Balanced
| env.setdefault("DRY_RUN", "true") | ||
| params = StdioServerParameters( | ||
| command=sys.executable, | ||
| args=[os.path.join(REPO, "mcp_server", "server.py")], |
| case " $* " in *" --output "*) ;; *) set -- "$@" --output "$WORK/overseer-results.json";; esac | ||
| exec "$PY" run_overseer.py "$@" | ||
| ;; | ||
| autopilot) | ||
| need_venv; gh_env; cd "$WORK" | ||
| case " $* " in *" --config "*) ;; *) set -- --config "$REPO/autopilot/config.yaml" "$@";; esac | ||
| case " $* " in *" --output "*) ;; *) set -- "$@" --output "$WORK/DAILY_SUMMARY.md";; esac |


Summary
Adds a project Claude Code skill at
.claude/skills/run-autonomous-github-agent/for launching and driving the agent locally.SKILL.md— documented, locally-verified commands covering the CLI, MCP stdio, risk scorer,.github/scripts, overseer, autopilot, and pytest.driver.sh— owns a venv outside the repo, runs from a clean cwd (the placeholder.envbreaks pydantic-settings, which forbids extra keys), and sets env (gh auth token, dummy LLM key).mcp_client.py— minimal MCP stdio client (mcp<2).No runtime code, workflows,
config/orcore/touched — docs/tooling only.Test plan
bash .claude/skills/run-autonomous-github-agent/driver.shruns on a clean checkout🤖 Generated with Claude Code