تشغيل أي مهارة في Manus بنقرة واحدة

generate-report

النجوم١

التفرعات٠

آخر تحديث٢٣ أبريل ٢٠٢٦ في ٠٧:١٥

Aggregates state across all 5 Pech sub-plugins and renders a dark-themed single-page PDF cost audit. Invokes anomaly-narrator agent (Opus) once per anomaly for human-readable diagnoses; invokes forecaster agent (Sonnet) for the forecast block. Use when: /pech-report slash command fires. Do not use for live session display (see cost-display) — report generation is a heavy operation costing ~$0.04 + $0.005 per anomaly.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

تشغيل في Manus

المصدر

enchanter-ai

enchanter-ai/pech

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

تشغيل في Manus

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مقدّرو التكاليفمهن الأعمال والعمليات المالية·SOC 13-1051

SKILL.md

readonly

name	generate-report
description	Aggregates state across all 5 Pech sub-plugins and renders a dark-themed single-page PDF cost audit. Invokes anomaly-narrator agent (Opus) once per anomaly for human-readable diagnoses; invokes forecaster agent (Sonnet) for the forecast block. Use when: /pech-report slash command fires. Do not use for live session display (see cost-display) — report generation is a heavy operation costing ~$0.04 + $0.005 per anomaly.
model	sonnet
tools	["Read","Write","Bash"]
phase2_status	Phase 2 — PDF generation pending (puppeteer + Chrome headless not yet wired). Phase 1 emits structured JSONL summary only.

generate-report

Preconditions

At least one session has been observed (ledger has ≥ 1 row)
docs/assets/package.json has been npm install'd — puppeteer + mermaid-cli required for PDF rendering

Inputs

Scope: current session (default), --session-id=<uuid>, or --day=<date>
Output path: default state/reports/report-<timestamp>.pdf

Steps

Aggregate. Read and combine:
- plugins/cost-tracker/state/ledger-YYYY-MM.jsonl (all rows in scope)
- plugins/cost-tracker/state/session.json#forecast (or re-run forecast-cost skill)
- plugins/budget-watcher/state/thresholds.jsonl (crossings in scope)
- plugins/budget-watcher/state/anomalies.jsonl (anomalies in scope)
- plugins/pech-learning/state/learnings.json (for L5 delta)
Narrate anomalies. For each anomaly row, delegate to budget-watcher/agents/anomaly-triager (Opus) with the row + surrounding ledger context. Collect the returned narratives.
Render HTML. Fill the report template (at templates/report.html — inline in this skill's dir for now) with: header, total, forecast block, attribution table, threshold-crossing timeline, anomaly section (with narratives), cache-waste summary, L5 delta.
Render PDF. Call docs/architecture/generate.py --report-html=<html> --out=<pdf-path> — which internally invokes Chrome headless via docs/assets/puppeteer.config.json.
Write PDF to output path. Return path + summary JSON.

Success criterion: PDF exists at the expected path, file size > 10KB (empty PDFs are a rendering failure), summary JSON returned with all aggregated stats.

Outputs

PDF at state/reports/report-<timestamp>.pdf
Summary JSON: {total_usd, n_anomalies, n_threshold_crossings, forecast, report_path}

Handoff

/pech-report slash command displays the PDF path; user opens it manually (or via --open flag).

Failure modes

Code	Scenario	Counter
F10	PDF generation fails silently with an empty file	Check file size > 10KB; fail loudly with the Chrome headless stderr
F11	Suppress anomaly rows from the report because they "look scary"	All anomalies go in the report; suppression defeats the audit
F13	Inline all 30 anomaly narratives at full Opus tier — cost explodes	Cap narratives at 10 (top anomalies by
F14	Use stale rate card for historical session replay without flagging	Report header must show `rate_card_effective_from` for the session being audited

المزيد من هذا المستودع

نفس المستودع

check-budget

enchanter-ai/pech

Runs L2 Budget Boundary Detection after each ledger write: increments per-scope counters, compares against ceilings in state/budgets.json, emits pech.budget.threshold.crossed on first crossing of each threshold within each scope-window. Use when: a PostToolUse hook fires and cost-tracker has already written the ledger row. Do not use for forecasting (see forecast-cost) or anomaly detection (see detect-anomaly).

2026-05-131

observe-call

enchanter-ai/pech

Writes a single ledger row for the most recent tool-use call: reads the API response's usage field (authoritative), looks up the model rate in shared/rate-card.json, applies prompt-cache modifiers (1.25× write, 0.1× read), computes billed cost, and appends to plugins/cost-tracker/state/ledger-YYYY-MM.jsonl. Use when: a PostToolUse hook fires for any tool and attribution metadata is available via ENCHANTED_ATTRIBUTION env. Do not use for forecasting (see /pech-forecast → forecast-cost) or for anomaly detection (see budget-watcher/detect-anomaly).

2026-05-131

refresh-rate-card

enchanter-ai/pech

Updates shared/rate-card.json with a new per-model rate table. Validates the proposed update against the existing schema, diffs prices against the current card, and produces a commit-ready diff for human review. Use when: CI nightly job detects a pricing change on Anthropic's published rate page, or when the developer runs /refresh-rate-card after verifying a price change. Do not use at runtime during a Claude Code session — this skill runs in CI or at developer invocation, never inside the observation hot path.

2026-05-131

rate-awareness

enchanter-ai/pech

Token-bucket advisory rate limiter per skill+session. Surfaces runaway tool-call loops in real time before pech/budget-watcher reports them post-hoc. Auto-fires on PreToolUse. Configurable per-skill limits via state/buckets.json. Do not use for cost reporting (see budget-watcher) or for blocking installs (see package-gate).

2026-05-131

rate-shield-awareness

enchanter-ai/pech

OPT-IN BLOCKING token-bucket rate limiter. Pairs with pech-rate-limiter (advisory). When state/rate-policy.json sets enabled:true, this shield blocks (exits 2) any tool call once the active (session, skill) bucket is empty. Reads buckets from rate-limiter's state/buckets.json when present; gracefully degrades when absent. Use when the developer asks why a tool call was rate-blocked, wants to enable or tune the rate policy, or reviews a stderr "rate-shield (BLOCKED)" message. Default disabled. Do not use for advisory-only velocity signals (see rate-limiter) or for cost reporting (see budget-watcher).

2026-05-131

accumulate-pattern

enchanter-ai/pech

Updates per-developer cost-pattern accumulator in state/learnings.json with the current session's observations. Rolls μ and σ per (skill, session_type, model) axis using a slow exponential update (α = 0.05) so one noisy session doesn't skew learned patterns. Exports a cross-plugin-readable snapshot to shared/learnings.json. Use when: PreCompact hook fires (end-of-session or compaction trigger). Do not use during an active session — runtime invocation mid-session would distort the pattern.

2026-04-231

name	generate-report
description	Aggregates state across all 5 Pech sub-plugins and renders a dark-themed single-page PDF cost audit. Invokes anomaly-narrator agent (Opus) once per anomaly for human-readable diagnoses; invokes forecaster agent (Sonnet) for the forecast block. Use when: /pech-report slash command fires. Do not use for live session display (see cost-display) — report generation is a heavy operation costing ~$0.04 + $0.005 per anomaly.
model	sonnet
tools	["Read","Write","Bash"]
phase2_status	Phase 2 — PDF generation pending (puppeteer + Chrome headless not yet wired). Phase 1 emits structured JSONL summary only.

generate-report

Preconditions

At least one session has been observed (ledger has ≥ 1 row)
docs/assets/package.json has been npm install'd — puppeteer + mermaid-cli required for PDF rendering

Inputs

Scope: current session (default), --session-id=<uuid>, or --day=<date>
Output path: default state/reports/report-<timestamp>.pdf

Steps

Aggregate. Read and combine:
- plugins/cost-tracker/state/ledger-YYYY-MM.jsonl (all rows in scope)
- plugins/cost-tracker/state/session.json#forecast (or re-run forecast-cost skill)
- plugins/budget-watcher/state/thresholds.jsonl (crossings in scope)
- plugins/budget-watcher/state/anomalies.jsonl (anomalies in scope)
- plugins/pech-learning/state/learnings.json (for L5 delta)
Narrate anomalies. For each anomaly row, delegate to budget-watcher/agents/anomaly-triager (Opus) with the row + surrounding ledger context. Collect the returned narratives.
Render HTML. Fill the report template (at templates/report.html — inline in this skill's dir for now) with: header, total, forecast block, attribution table, threshold-crossing timeline, anomaly section (with narratives), cache-waste summary, L5 delta.
Render PDF. Call docs/architecture/generate.py --report-html=<html> --out=<pdf-path> — which internally invokes Chrome headless via docs/assets/puppeteer.config.json.
Write PDF to output path. Return path + summary JSON.

Success criterion: PDF exists at the expected path, file size > 10KB (empty PDFs are a rendering failure), summary JSON returned with all aggregated stats.

Outputs

PDF at state/reports/report-<timestamp>.pdf
Summary JSON: {total_usd, n_anomalies, n_threshold_crossings, forecast, report_path}

Handoff

/pech-report slash command displays the PDF path; user opens it manually (or via --open flag).

Failure modes

Code	Scenario	Counter
F10	PDF generation fails silently with an empty file	Check file size > 10KB; fail loudly with the Chrome headless stderr
F11	Suppress anomaly rows from the report because they "look scary"	All anomalies go in the report; suppression defeats the audit
F13	Inline all 30 anomaly narratives at full Opus tier — cost explodes	Cap narratives at 10 (top anomalies by
F14	Use stale rate card for historical session replay without flagging	Report header must show `rate_card_effective_from` for the session being audited