Home / trpc-group / trpc-agent-python · examples/optimization/eval_optimize_loop/DESIGN.md · GitHub

DESIGN.md@examples/optimization/eval_optimize_loop designA

DESIGN.md@examples/optimization/eval_optimize_loop is agent-read markdown (design) from trpc-group/trpc-agent-python.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# 设计边界

本示例把运行环境与替代组件分开描述。`offline`、`real`、`trace` 是三种 Pipeline 运行模式。`offline` 仍使用 SDK 的 `LlmAgent`、Runner 和独立 Session,只把 Agent 内部模型替换成 `DeterministicFakeModel`,并用确定性 Candidate Provider 代替真实优化器。它用于验证 Prompt 改变是否经过真实 Agent 编排影响输出。

`real` 使用真实业务模型生成回复,并由 `AgentOptimizer` 调用真实反思模型产生 Prompt 候选;只有 Gate 接受、源 Prompt 哈希未漂移且显式启用写回时,才允许更新源文件。

`trace` 直接评测预录制的 `actual_conversation`,不再次运行 Agent、Model 或 Candidate Provider。它适合复现工具轨迹和生产故障,但只能证明候选版本与轨迹的关联,不能证明 Prompt 导致了该轨迹。因此 Trace 即使获得 ACCEPT,也固定跳过源 Prompt 写回。

确定性 metric 负责精确匹配等硬规则。LLM Judge 若需要,应作为带 rubric 的评测指标显式配置;本示例不提供容易混淆职责的 `use_fake_judge` 开关。

Read the whole file at its exact version.

How to install

Latest version
mdr add trpc-group/trpc-agent-python/examples/optimization/eval_optimize_loop/DESIGN.md@git:20260805.9e82694
Exact content
mdr add trpc-group/trpc-agent-python/examples/optimization/eval_optimize_loop/DESIGN.md@sha256:f61af41890a928f7

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_es4s56xs3j2bcexj.svg)](https://markdownregistry.com/a/art_es4s56xs3j2bcexj)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260805.9e82694 latest2026-08-05 9e82694 1,126 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (1126 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

trpc-group/trpc-agent-python · 143 stars · license NOASSERTION · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_es4s56xs3j2bcexj
GET https://markdownregistry.com/api/v1/resolve?ref=trpc-group/trpc-agent-python/examples/optimization/eval_optimize_loop/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/f61af41890a928f7a11905d4a84d58008570c57ce538674bf95e2ed46880c220

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from trpc-group/trpc-agent-python

Travel Planning Assistant skill
trpc-group/trpc-agent-python · examples/claude_agent_with_skills/.claude/skills/traver_helper/SKILL.md · Automatically generate a comprehensive travel plan based on user's travel needs (destination, date, budget, etc.)…
git:20260401.f485ee4 · audit A · 143 stars
city-info skill
trpc-group/trpc-agent-python · examples/optimization/blackbox_cli/workspace/.claude/skills/city-info/SKILL.md · 城市信息
git:20260520.dde5f18 · audit B · 143 stars
CLAUDE.md@examples/optimization/blackbox_cli/workspace claude
trpc-group/trpc-agent-python · examples/optimization/blackbox_cli/workspace/CLAUDE.md
git:20260520.dde5f18 · audit B · 143 stars
data-analysis skill
trpc-group/trpc-agent-python · examples/skills/skills/data_analysis/SKILL.md · Python-based data analysis tools using pandas and numpy for data processing and visualization.
git:20260401.f485ee4 · audit A · 143 stars
file-tools skill
trpc-group/trpc-agent-python · examples/skills/skills/file_tools/SKILL.md · Simple shell utilities for files and archives.
git:20260401.f485ee4 · audit A · 143 stars
python-math skill
trpc-group/trpc-agent-python · examples/skills/skills/python-math/SKILL.md · Small Python utilities for math and text files.
git:20260509.8d2cacd · audit A · 143 stars
user-file-ops skill
trpc-group/trpc-agent-python · examples/skills/skills/user_file_ops/SKILL.md · Simple operations on user-provided text files including summarization.
git:20260401.f485ee4 · audit A · 143 stars
code-review skill
trpc-group/trpc-agent-python · examples/skills_code_review_agent/skills/code-review/SKILL.md · Review unified diffs, file lists, or Git worktree changes inside an isolated workspace and return evidence-based…
git:20260802.b4ea8cc · audit A · 143 stars
python-math skill
trpc-group/trpc-agent-python · examples/skills_with_container/skills/python-math/SKILL.md · Small Python utilities for math and text files.
git:20260509.8d2cacd · audit A · 143 stars
python-math skill
trpc-group/trpc-agent-python · examples/skills_with_cube/skills/python-math/SKILL.md · Small Python utilities for math and text files.
git:20260603.614b07d · audit A · 143 stars
weather-tools skill
trpc-group/trpc-agent-python · examples/skills_with_dynamic_tools/skills/weather-tools/SKILL.md · Weather information query tools including current weather, forecast, and location search.
git:20260401.f485ee4 · audit A · 143 stars
leader-research skill
trpc-group/trpc-agent-python · examples/team_with_skill/skills/leader_research/SKILL.md · Generate concise research bullet points for the team leader.
git:20260401.f485ee4 · audit A · 143 stars

Every file in trpc-group/trpc-agent-python

Browse by kind, by grade A, or by owner.