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)

举报或申请下架