Rea Analysis Optimization

morluto/rea/.agents/skills/rea-analysis-optimization

作者 morluto015a02d57b567bc9a1ed792d1e4b3ec083fa0ae3無授權條款472K 個星標收錄於 2026年10月20日更新於 2026年11月7日儲存庫今天更新

Optimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.

僅含說明軟體開發
AI 產生的概覽

指導 REA 分析提供者與共用分析流程的效能最佳化,在維持正確性的前提下降低延遲、CPU 與記憶體用量。

功能
提供一套工作流程:找出分析提供者及共用 CLI/MCP 分析路徑中多餘的工作,選擇最小的結構性修正,並明確定義快取或共用的生命週期。要求建立獨立於被改實作的正确性基準,按階段量測,並在輸入、結果、涵蓋範圍與 Evidence 語意等價的前提下,比較修改前後的完整任務。最後報告瓶頸、所屬修改、維持的語意、已執行的檢查、量測資料與剩餘限制。
適用情境
適用於分析流程有具體效能瓶頸或回歸疑慮時,或需要為分析提供者設計快取、查詢與共用策略時。不適用於例行清理或 CI/測試套件最佳化。
執行需求
僅為說明文件,不含腳本。需要存取程式碼儲存庫的取出目錄及其效能、工具設計與測試指南,參考隨附的 Kuna 案例研究,並能執行真實的公開工作流程並使用效能剖析與量測工具。

REA analysis optimization

Find a concrete source of unnecessary work, change it at its owner, and verify equivalent completed investigations. A useful outcome can also be a measured decision to leave an implementation alone.

Follow the checkout's performance priorities, tool design, and testing guide. This skill supplies an optimization workflow, not additional permission to execute targets, publish, or merge. Use the current contracts, provider prerequisites, and user authorization.

Reserve performance measurements for changes that target performance or have a concrete regression concern. Routine cleanup uses correctness checks and does not require this optimization workflow or synthetic benchmarks merely because helper calls, imports, or representations change.

Read the Kuna case study [blocked] when selecting a reuse strategy or interpreting a benchmark. Its pinned observations illustrate tradeoffs; they are not current-provider guarantees or universal speedups.

Pin the question and the correctness oracle

Describe the analyst's completed task, including the facts and relationships needed to answer it, requested detail, source access, and meaningful unknowns. Choose a representative real artifact and a small or empty case. Record the baseline revision, target digest, engine identity, options, host, and entrypoint. Use a separate checkout for changes without disturbing other work.

Establish an oracle independent of the changed implementation: source-built fixture expectations, independently mapped file bytes, or a native producer paired with checks of its interpretation. Comparing two wrappers around the same faulty decoder does not establish correctness. Preserve address widths, same-address alternatives, unresolved endpoints, coverage, and source linkage. An empty result proves absence only within the actually examined scope.

Locate the earliest unnecessary work

Trace one public CLI or MCP task through shared application code to its producer. Measure relevant phases: admission and identity checks, native analysis, decoding, lookup, projection, serialization, Evidence retention, and cleanup. Include catalog discovery and extra calls when they affect the completed task.

Use the evidence to choose the smallest structural correction:

Observed costCandidate correctionCondition to establish
Repeated scans of validated factsReuse existing order or lookup structureThe owner establishes ordering and identity; every matching alternative survives
Repeated equivalent engine workShare a validated result or in-flight producerInputs, freshness, lifetime, and per-caller outcomes remain explicit
Full reports for selected factsPush selection or projection to the earliest capable ownerRequired facts and evidence remain reachable; examined coverage is reported
Large temporary transport buffersDecode incrementally or use bounded source readsValidate the whole admitted document; retained facts and copies still consume memory
Many repeated homogeneous readsShare admission, decoding, or batch workPreserve item identity, order where required, and individual failures

Do not introduce an index, generic cache, batch endpoint, or orchestration layer without identifying the work it removes and its maintenance/resource cost. Projection after materializing a full report may reduce output while leaving analysis time and peak memory unchanged. Fix missing or incorrect facts before benchmarking an alternative composition against a better-covered workflow.

Keep one interpretation and a defined reuse lifetime

Let the producer boundary validate and normalize facts once. Consumers query that representation through the shared CLI/MCP implementation; adapters should not rebuild relationships or independently reinterpret raw reports. Keep lookup identity separate from display formatting. Reuse contracts when their intent matches, honoring requested detail and complete Evidence access.

For every cache or shared producer, state its key, owner, invalidation, retained size, and lifetime. Account for result-affecting target bytes, engine contents, analysis options, architecture/load mapping, and parser/schema versions where they affect reuse. Validate live state before calling a cached observation current. Cache a refusal only when it is deterministic for that validated key; malformed, partial, transient, or cancelled attempts need explicit retry policy.

One cancelled waiter must not invalidate a successful peer. Preserve producer failure context and each caller's cancellation reason. Retain ownership and capacity charges until shared work and cleanup settle; preserve completed observations when cleanup fails. Exercise invalidation, concurrent consumers, last-waiter cancellation, close, and cleanup retry when those paths change.

Bound the process family and retained state, not just a parent heap or worker count. Account for decoding and serialization expansion before allocation. Choose CPU, memory, concurrency, and disk limits from the host and workload; stop before OOM and verify owned cleanup. A guard-stopped task is incomplete. Do not replace a transport buffer cap with an unbounded retained inventory or hide partial results behind a success status.

Compare completed tasks and limit the claim

Run the affected real public workflow before and after with equivalent inputs, results, coverage, and Evidence semantics. Include small inputs so setup costs and regressions are visible. Distinguish fresh sessions, warm runtime caches, and OS file caches. Alternate or repeat runs when variance affects the decision. Choose meaningful boundary regressions for cases the actual engine cannot reliably reproduce; a fake engine does not qualify a real provider.

Report task outcome, relevant phase timings, total elapsed and CPU time, peak process-family memory and its accounting method, resource stops, and cleanup. Check the payload exit status as well as the profiler's. Keep failed attempts and identify unmeasured costs; a passing retry does not explain a failure.

For token claims, count schemas/discovery, arguments, replies, retries, and continuations needed to finish the task. Label tokenizer estimates separately from actual model usage and record the client/catalog behavior. Smaller JSON alone establishes neither fewer model tokens nor better investigation quality. Do not claim a complex-software advantage without completed representative investigations and comparable correctness/coverage.

Finish with the bottleneck, owning change, preserved semantics, executed checks, before/after measurements, and remaining limits. Keep any integration record current with its tested revision and distinguish merged production work from experiment-only code. Stop when the demonstrated bottleneck is resolved or further benefit remains speculative.

來源與署名

來源:morluto/rea位於.agents/skills/rea-analysis-optimization提交015a02d

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

在 README 中新增徽章

向讀者展示該技能已收錄於 SourceWeft,徽章連結到本頁。

「Listed on SourceWeft」徽章預覽
[![Listed on SourceWeft](https://sourceweft.com/badge/skills/gh-morluto-rea-rea-analysis-optimization-agents-skills-rea-analysis-optimization-d4f23465ab682ae5.svg)](https://sourceweft.com/skills/gh-morluto-rea-rea-analysis-optimization-agents-skills-rea-analysis-optimization-d4f23465ab682ae5?utm_source=readme&utm_medium=badge)

檢舉或申請下架