ghe-report
生成包含指标、健康检查或史诗特定分析的详细报告。比快速状态概览更全面。当以下情况使用此技能:- 用户要求"指标"或"统计"或"性能报告"- 用户要求"健康检查"或"工作流健康"或"合规检查"- 用户要求"史诗报告"或"X的史诗状态"- 用户要求"详细报告"或"全面报告"- 用户询问"我们的表现如何"或"我们的吞吐量是多少"- 用户询问"周期时间"或"降级率"- 用户想要分析,而不仅仅是当前状态报告类型:- 指标:吞吐量、周期时间、首次通过率、降级率- 健康:合规状态、陈旧线程、违规历史、内存库状态- 史诗:包含线程历史、进度、决策的单个史诗细节不要在以下情况下使用此技能:- 用户只是想要快速状态概览(使用ghe-status)- 用户想要认领问题(使用ghe-claim)- 用户想要发布检查点(使用ghe-checkpoint)- 用户想要转换阶段(u
name: ghe-report description: | Generate DETAILED reports with metrics, health checks, or epic-specific analysis. More comprehensive than quick status overview.
USE THIS SKILL WHEN:
- User asks for "metrics" or "statistics" or "performance report"
- User asks for "health check" or "workflow health" or "compliance check"
- User asks for "epic report" or "epic status for X"
- User asks for "detailed report" or "comprehensive report"
- User asks "how are we performing" or "what's our throughput"
- User asks about "cycle times" or "demotion rates"
- User wants analysis, not just current state
REPORT TYPES:
- metrics: Throughput, cycle times, first-pass rates, demotion rates
- health: Compliance status, stale threads, violation history, memory bank status
- epic: Single epic details with thread history, progress, decisions
DO NOT USE THIS SKILL WHEN:
- User just wants QUICK status overview (use ghe-status)
- User wants to CLAIM an issue (use ghe-claim)
- User wants to POST a checkpoint (use ghe-checkpoint)
- User wants to TRANSITION phases (use ghe-transition)
KEY DIFFERENCE FROM ghe-status:
- ghe-status = quick overview, current state, what's active
- ghe-report = detailed analysis, metrics, trends, health assessment
EXAMPLES: Context: User wants performance metrics user: "Show me the workflow metrics" assistant: "I'll use ghe-report with type 'metrics' for detailed performance analysis" Context: User wants to check workflow compliance user: "Run a health check on the workflow" assistant: "I'll use ghe-report with type 'health' to assess workflow compliance" Context: User wants details on specific epic user: "Give me a report on the jwt-auth epic" assistant: "I'll use ghe-report with type 'epic' for jwt-auth" Context: User asks about performance trends user: "What's our first-pass review rate?" assistant: "I'll use ghe-report with type 'metrics' to get performance statistics"
---IRON LAW: User Specifications Are Sacred
THIS LAW IS ABSOLUTE AND ADMITS NO EXCEPTIONS.
- Every word the user says is a specification - follow verbatim, no errors, no exceptions
- Never modify user specs without explicit discussion - if you identify a potential issue, STOP and discuss with the user FIRST
- Never take initiative to change specifications - your role is to implement, not to reinterpret
- If you see an error in the spec, you MUST:
- Stop immediately
- Explain the potential issue clearly
- Wait for user guidance before proceeding
- No silent "improvements" - what seems like an improvement to you may break the user's intent
Violation of this law invalidates all work produced.
Background Agent Boundaries
When running as a background agent, you may ONLY write to:
- The project directory and its subdirectories
- The parent directory (for sub-git projects)
- ~/.claude (for plugin/settings fixes)
- /tmp
Do NOT write outside these locations.
GHE_REPORTS Rule (MANDATORY)
ALL reports MUST be posted to BOTH locations:
- GitHub Issue Thread - Full report text (NOT just a link!)
- GHE_REPORTS/ - Same full report text (FLAT structure, no subfolders!)
Report naming: <TIMESTAMP>_<title or description>_(<AGENT>).md
Timestamp format: YYYYMMDDHHMMSSTimezone
Example: 20251206200000GMT+01_status_report_(Hermes).md
ALL 11 agents write here: Athena, Hephaestus, Artemis, Hera, Themis, Mnemosyne, Hermes, Ares, Chronos, Argos Panoptes, Cerberus
REQUIREMENTS/ is SEPARATE - permanent design documents, never deleted.
Deletion Policy: DELETE ONLY when user EXPLICITLY orders deletion due to space constraints. DO NOT delete during normal cleanup.
Settings Awareness
Respects .claude/ghe.local.md:
enabled: If false, return minimal reportnotification_level: verbose/normal/quiet - affects detail levelstale_threshold_hours: Used for stale thread detection
GitHub Elements Report (Detailed Analysis)
Purpose: Generate detailed reports with metrics, health assessment, or epic analysis. More comprehensive than quick status.
Report Types
1. Metrics Report
Performance indicators and trends:
- Throughput (features completed, bugs fixed)
- Cycle times (average sessions per phase)
- First-pass REVIEW rate
- Demotion rate
- Agent performance comparison
2. Health Report
Workflow compliance assessment:
- Rule compliance status
- Stale threads detection
- Violation history
- Memory bank synchronization status
- Overall health score
3. Epic Report
Single epic deep dive:
- Thread history (all DEV/TEST/REVIEW cycles)
- Current phase and progress
- Key technical decisions
- Remaining work estimation
When to Use
- Performance analysis
- Compliance audits
- Epic-specific status
- Trend analysis
- Health assessment
How to Execute
Spawn reporter agent with appropriate report type:
reporter(type="metrics") → Performance report
reporter(type="health") → Compliance report
reporter(type="epic", epic="epic-name") → Epic report
Output Formats
Metrics Report
## GitHub Elements Metrics Report
### Throughput
| Metric | Value | Trend |
|--------|-------|-------|
| Features completed | N | +/- vs last week |
| Bugs fixed | N | +/- vs last week |
### Cycle Times
| Phase | Avg Duration | Issues Processed |
|-------|--------------|------------------|
| DEV | N sessions | N |
| TEST | N sessions | N |
| REVIEW | N sessions | N |
### Quality Metrics
- First-pass REVIEW rate: N%
- Demotion rate: N%
- Test coverage (avg): N%
Health Report
## GitHub Elements Health Report
### Compliance Status
| Rule | Status | Notes |
|------|--------|-------|
| One thread at a time | PASS/FAIL | |
| Phase order | PASS/FAIL | |
| Checkpoint frequency | PASS/WARN | |
### Stale Threads
[Threads with no activity > 24h]
### Violation History
[Recent violations and resolutions]
### Overall Health
[HEALTHY / WARNINGS / CRITICAL]
Epic Report
## Epic Report: [Epic Name]
### Thread History
| Issue | Type | Status | Duration |
|-------|------|--------|----------|
### Current Phase
[Current phase with progress]
### Key Decisions
[Technical decisions made]
### Remaining Work
[Estimated remaining effort]
Key Differentiator
This skill provides DETAILED ANALYSIS. For a quick current-state overview, use ghe-status instead.