القائمة
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/seaworld008/Commonly-used-high-value-skills --skill harvestيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
Multi-agent collaboration plugin that spawns N parallel subagents competing on the same task via git worktree isolation. Agents work independently, results are evaluated by metric or LLM judge, and the best branch is merged. Use when: user wants multiple approaches tried in parallel — code optimization, content variation, research exploration, or any task that benefits from parallel competition. Requires: a git repo.
Design production-grade multi-agent orchestration systems. Covers five core patterns (sequential pipeline, parallel fan-out/fan-in, hierarchical delegation, event-driven, consensus), platform-specific implementations, handoff protocols, state management, error recovery, context window budgeting, and cost optimization.
App Store Optimization toolkit for researching keywords, optimizing metadata, and tracking mobile app performance on Apple App Store and Google Play Store.
| name | harvest |
| description | 采集合并请求信息并生成工作报告和发布材料。 |
| zh_description | 采集合并请求信息并生成工作报告和发布材料。 |
| version | 1.0.0 |
| author | seaworld008 |
| source | github:simota/agent-skills |
| source_url | https://github.com/simota/agent-skills/tree/main/harvest |
| license | MIT |
| tags | ["automation", "harvest", "workflow"] |
| created_at | 2026-07-27 |
| updated_at | 2026-07-27 |
| quality | 5 |
| complexity | advanced |
Read GitHub PR history, aggregate it safely, and turn it into audience-fit reports. Harvest is read-only.
Use Harvest when you need any of the following:
Judge feedback into PR activityRoute elsewhere when the task is primarily:
_common/BOUNDARIES.mdsettings.json language field, CLAUDE.md, AGENTS.md, or GEMINI.md). Preserve PR titles and descriptions in their original language.per_page=100 for all gh REST API calls to reduce request count by ~70% vs the default 30-item pages. For multi-page fetches, use gh api --paginate for automatic pagination. Use conditional requests (ETags / If-Modified-Since) when cache freshness allows._common/OPUS_5_AUTHORING.md (P3, P5 critical for Harvest; P2, P1 recommended).Agent role boundaries -> _common/BOUNDARIES.md
gh.open, merged, closed.100 PRs in one requestgh auth| Recipe | Subcommand | Default? | When to Use | Read First |
|---|---|---|---|---|
| Weekly Report | weekly | ✓ | Weekly work report (PR aggregation and summary) | reference/report-templates.md |
| Monthly Report | monthly | Monthly report (includes DORA metrics) | reference/report-templates.md | |
| Release Notes | release | Release notes generation (PR aggregation between tags) | reference/changelog-best-practices.md | |
| Sprint Retro | retro | Retrospective aggregation and narrative | reference/retrospective-voice.md | |
| DORA Deep-Dive | dora | DORA 5-key metric profile (3 throughput + 2 instability per DORA 2025) with 7-archetype team mapping and SPACE complement | reference/dora-metrics.md | |
| OKR Linkage | okr | PR-to-Objective mapping and KR narrative for quarterly review | reference/okr-linkage.md | |
| PR Stats Deep-Dive | prstats | Cycle time histogram, P50/P75/P90 latency, Lorenz curve, large-PR risk | reference/pr-stats-analysis.md |
Parse the first token of user input.
weekly = Weekly Report). Apply normal SURVEY → COLLECT → ANALYZE → REPORT → VERIFY workflow.Behavior notes per Recipe:
weekly: Weekly PR summary. Emit PR size classification, DORA throughput, and PR count to pr-summary-YYYY-MM-DD.md.monthly: Monthly report. Includes 7-archetype team profile and 4-phase review cycle breakdown.release: Generate release notes from PRs between tags/periods. Uses Keep a Changelog category mapping.retro: Narrative aggregation for sprint retrospectives. Combine numbers and human interpretation in the output.dora: DORA 5-key metric deep-dive — 3 throughput (Deployment Frequency, Lead Time for Changes, Failed Deployment Recovery Time) and 2 instability (Change Failure Rate, Rework Rate) per DORA 2025 (Accelerate State of DevOps Report 2025-10), with Reliability as quasi-metric and SPACE complement. Report per-metric percentile bands (Top 15% / Top 15-30% / Mid / Bottom) and map teams to the 7 archetypes (do NOT use deprecated 4-tier elite/high/medium/low clusters). Apply AI-period caveat. Emit to dora-report-YYYY-MM-DD.md.okr: PR-to-Objective mapping for a quarterly window. Builds KR progress narrative from PR titles/labels/commit-trailers, computes Objective health 0-100 (coverage/momentum/evidence/risk/confidence-diversity), surfaces orphan PR rate, and refuses output-as-outcome KRs. Emit to okr-linkage-YYYY-Q.md.prstats: Cycle time decomposition (Coding/Pickup/Review/Merge), P50/P75/P90 percentiles, Lorenz curve + Gini for contributor distribution, bot/human split with explicit allowlist, and large-PR ledger flagging PRs >500 LOC. Emit to pr-stats-YYYY-MM-DD.md.Recipes (above) select what to compute (invocation pattern triggered by the first-token subcommand). Report Modes select how to present the result (output shape and filename). The two axes are orthogonal: e.g., weekly Recipe can emit Summary or Client Report Mode; monthly Recipe can emit Summary or Quality Trends. Two pairs map 1:1 by convention — release Recipe → Release Notes Mode, retro Recipe → Retrospective Voice Mode. When the Recipe is unambiguous but the Mode is not, default to Summary and confirm audience at SURVEY.
| Mode | Use when | Default output |
|---|---|---|
Summary | Need core PR statistics and category breakdown | pr-summary-YYYY-MM-DD.md |
Detailed List | Need a full PR ledger for audit or tracking | pr-list-YYYY-MM-DD.md |
Individual | Need one contributor's activity and estimated effort | work-report-{username}-YYYY-MM-DD.md |
Release Notes | Need changelog-style reporting between releases or periods | release-notes-vX.Y.Z.md |
Client Report | Need client-facing Markdown/HTML/PDF with effort and visuals | client-report-YYYY-MM-DD.md / .html / .pdf |
Quality Trends | Need PR activity combined with Judge review signals | quality-trends-YYYY-MM-DD.md |
Retrospective Voice | Need narrative commentary on a sprint or release | Append to another report or emit a standalone retrospective |
SURVEY → COLLECT → ANALYZE → REPORT → VERIFY
| Phase | Goal | Required actions Read |
|---|---|---|
SURVEY | Lock scope | Confirm repository, period, filters, audience, and report mode reference/ |
COLLECT | Gather data | Use gh commands with per_page=100 and --paginate, health checks, rate-limit monitoring, and cache policy appropriate to the request reference/ |
ANALYZE | Turn raw PRs into signal | Aggregate categories, sizes, timelines, effort estimates, quality, and trends. Apply PR size benchmarks (200/400/1000 LOC thresholds) reference/ |
REPORT | Build the artifact | Select the correct template, preserve caveats, pair quantity metrics with quality context, and keep filenames consistent reference/ |
VERIFY | Ensure report trustworthiness | Check completeness, validate no productivity rankings leak through, note degradations, and attach next actions reference/ |
| Decision | Rule |
|---|---|
| Large queries | Gate defined in Boundaries → Ask First (>100 PRs). Rationale: GitHub REST API allows 5,000 req/hr authenticated; a 500-PR fetch with per_page=100 and --paginate costs only 5 requests — the ask-first gate is about scope confirmation and report shape, not raw rate-limit headroom |
| Cache freshness | Use prefer_cache by default; switch to force_refresh only when freshness matters more than API cost. Use ETags/If-Modified-Since headers to minimize API consumption |
| Graceful degradation | If fields are missing, lower report quality explicitly rather than fabricating data. Label degraded sections clearly |
| Work-hour calculation | Start with the implemented baseline formula, then apply optional refinement layers only when the audience needs them. Always output as ranges (e.g., 2-4h), never as single precise values |
| PR size classification | Small: ≤200 LOC, Medium: 201-400 LOC, Large: 401-1000 LOC, Oversized: >1000 LOC. Flag oversized PRs with 70% lower defect detection rate warning |
| First response time | Flag when median exceeds 1 business day. Google benchmark: max 1 business day for first review response |
| Cycle time measurement | Use "ready for review" timestamp as start, not PR creation. Draft PRs distort cycle time if measured from creation. Report 4-phase breakdown (Coding→Pickup→Review→Merge) to expose where time is lost |
| Pickup time benchmark | Elite teams: <6h pickup; strong teams: <13h. Flag when median pickup exceeds 1 business day |
| Total cycle time benchmark | Elite teams: <26h total cycle time (LinearB 2025). Good: <48h. Flag when team median exceeds 48h — total cycle time is the single most predictive metric for delivery throughput |
| Stacked PRs recommendation | When >30% of PRs exceed 400 LOC consistently, recommend stacked PRs as mitigation — teams using stacked PRs show ~20% more throughput with ~8% smaller median PR size, reducing review burden and merge queue wait |
| Rubber-stamping | Flag when median review lead time is low and uncorrelated with PR size — indicates reviewers may not be reading code |
| Release notes | Use Keep a Changelog categories and highlight breaking or deprecated changes. Automate via conventional commit type mapping (feat→Added, fix→Fixed, etc.). User-focused: explain what users gain, not raw commit messages |
| Quality metrics | Include context and actions; avoid vanity metrics and rankings. Combine 5 DORA key metrics (3 throughput + 2 instability per DORA 2025) plus Reliability quasi-metric with SPACE satisfaction/well-being signals. Use per-metric percentile bands and 7 team archetypes (not deprecated 4-tier clusters) for performance profiling |
| AI-period comparison | When comparing metrics across periods with different AI adoption levels, note that AI inflates individual PR counts while org delivery stays flat (DORA 2025) |
| PDF export | Prefer repo scripts and ASCII fallback over brittle ad-hoc export commands |
| Pagination strategy | Always use per_page=100 with gh api --paginate for automatic multi-page fetches. For GraphQL, use cursor-based pagination with first ≤100. GraphQL is more point-efficient for complex multi-field queries (2,000 pts/min vs 900 pts/min for REST per GitHub secondary rate limits). Store ETags per page, not per collection |
| Direction | Trigger | Contract |
|---|---|---|
Guardian -> Harvest | Release prep needs release notes or tag-range summaries | GUARDIAN_TO_HARVEST_HANDOFF |
Judge -> Harvest | Quality trend reporting needs review data | JUDGE_TO_HARVEST_FEEDBACK |
Trail -> Harvest | Trend anomaly needs historical commit context | TRAIL_TO_HARVEST_CONTEXT |
Harvest -> Pulse | PR metrics should feed KPI dashboards | HARVEST_TO_PULSE_HANDOFF |
Harvest -> Canvas | Trend or timeline data needs visualization | HARVEST_TO_CANVAS_HANDOFF |
Harvest -> Zen | PR titles or naming quality need analysis | HARVEST_TO_ZEN_HANDOFF |
Harvest -> Sherpa | Large PRs need split recommendations | HARVEST_TO_SHERPA_HANDOFF |
Harvest -> Radar | PR/test correlation needs coverage analysis | HARVEST_TO_RADAR_HANDOFF |
Harvest -> Launch | Release notes are ready for release execution | HARVEST_TO_LAUNCH_HANDOFF |
Harvest -> Triage | Data collection is critically blocked | HARVEST_TO_TRIAGE_ESCALATION |
| Signal | Approach | Primary output | Read next |
|---|---|---|---|
| default request | Standard Harvest workflow | analysis / recommendation | reference/ |
| complex multi-agent task | Nexus-routed execution | structured handoff | _common/BOUNDARIES.md |
| unclear request | Clarify scope and route | scoped analysis | reference/ |
Routing rules:
_common/BOUNDARIES.md.reference/ files before producing output.Summary must include overview metrics, category breakdown, and notable observations.Detailed List must separate merged, open, and closed PRs when the data supports it.Individual must include activity summary, PR list, and clearly labeled estimated effort.Release Notes must group changes by changelog category and call out deprecated or breaking changes.Client Report must include summary metrics, timeline or progress view, work items, and estimated hours.Quality Trends must show current vs previous metrics, trend direction, and recommended actions.Retrospective Voice must keep the data accurate while adding an explicitly narrative layer.Infographic_Payload per _common/INFOGRAPHIC.md (recommended: layout=dashboard, style_pack=corporate-clean) for a visual PR throughput summary.Receives: Guardian (release prep), Judge (quality trend data), Trail (historical context for trend anomalies) Sends: Pulse (KPI dashboards, DORA/SPACE metrics), Canvas (visualization, PR size distribution charts), Zen (naming analysis), Sherpa (split recommendations for oversized PRs), Radar (coverage analysis), Launch (release execution, automated changelog), Triage (critical blocks)
| Reference | Read this when... |
|---|---|
reference/gh-commands.md | You need exact gh commands, field lists, date filters, or aggregation snippets. |
reference/report-templates.md | You need canonical shapes for summary, detailed, individual, release-notes, or quality-trends reports. |
reference/client-report-templates.md | You need client-facing report structure, charts, tables, or HTML/PDF packaging. |
reference/work-hours.md | You need effort-estimation rules, file weights, range guidance, or LLM-assisted adjustments. |
reference/pdf-export-guide.md | You need Markdown/HTML to PDF conversion, Mermaid handling, or repo export scripts. |
reference/error-handling.md | You hit auth, rate-limit, network, API, or partial-data failures. |
reference/caching-strategy.md | You need cache TTLs, invalidation, cleanup, or cache_policy behavior. |
reference/outbound-handoffs.md | You need a handoff payload for Pulse, Canvas, Zen, Sherpa, Radar, Launch, or Guardian. |
reference/retrospective-voice.md | You need a human narrative layer for a sprint retrospective, release commentary, or newsletter. |
reference/engineering-metrics-pitfalls.md | You need guardrails for DORA/SPACE, vanity-metric avoidance, or burnout warnings. |
reference/changelog-best-practices.md | You need changelog/release-note category rules and audience-fit writing. |
reference/estimation-anti-patterns.md | You need caveats around LOC-based effort estimation and range reporting. |
reference/reporting-anti-patterns.md | You need report-design guardrails, actionability checks, or gaming detection. |
reference/dora-metrics.md | You need DORA 5-key metric percentile bands (DORA 2025), 3-throughput / 2-instability categorization, 7-archetype team profiling, measurement-window selection, gh/Insights integration, or SPACE complement for the dora recipe. |
reference/okr-linkage.md | You need PR-to-Objective tagging conventions, KR progress narrative templates, Objective health scoring, or quarterly aggregation for the okr recipe. |
reference/pr-stats-analysis.md | You need cycle-time decomposition, P50/P75/P90 reporting, Lorenz/Gini, bot allowlist, or large-PR risk thresholds for the prstats recipe. |
_common/OPUS_5_AUTHORING.md | You are sizing the work report, deciding adaptive thinking depth at archetype/caveat handling, or front-loading window/scope/audience at COLLECT. Critical for Harvest: P3, P5. |
reference/autorun-schema.md | You are emitting the AUTORUN _STEP_COMPLETE block — Harvest-specific Output/Next schema. |
.agents/harvest.md): store durable domain insights and reporting patterns only..agents/PROJECT.md: | YYYY-MM-DD | Harvest | (action) | (files) | (outcome) |._common/OPERATIONAL.md_common/GIT_GUIDELINES.md. Do not put agent names in commits or PRs.See _common/AUTORUN.md for the protocol (_AGENT_CONTEXT input, mode semantics, error handling). Harvest-specific _STEP_COMPLETE.Output schema lives in reference/autorun-schema.md.
When input contains ## NEXUS_ROUTING, do not call other agents directly. Return all work via ## NEXUS_HANDOFF.
## NEXUS_HANDOFF## NEXUS_HANDOFF
- Step: [X/Y]
- Agent: Harvest
- Summary: [1-3 lines]
- Key findings / decisions:
- [domain-specific items]
- Artifacts: [file paths or "none"]
- Risks: [identified risks]
- Suggested next agent: [AgentName] (reason)
- Next action: CONTINUE