DESIGN.md@internal/systemoneA

DESIGN.md@internal/systemone from trpc-group/trpc-agent-go is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add trpc-group/trpc-agent-go/internal/systemone/DESIGN.md@git:20261010.5344490

Pins git:20261010.5344490 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
trpc-group/trpc-agent-go
Path
internal/systemone/DESIGN.md
Versions recorded
1
Latest version
git:20261010.5344490, committed Oct 10, 2026
Size
21,159 bytes
Repository stars
1,906
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# System One Request Response 设计

本方案已经确认并落实到当前代码。接口以调用方直接传入业务数据、用文本描述问题、按 ID 读取具体答案为主路径。Go 接口负责表达使用意图;JSON 字段、协议类型标记和响应中的数字字符串键由内部编解码负责。

本包仍位于 `internal/systemone`,供 tRPC 仓库内的适配层复用。本文所说的调用方,是能够导入该 internal 包的 Go 代码。审批策略、阈值、上下文采集、模型路由和重试仍由各自的上层负责。本轮不更改 `NewClient`、`SystemOne` 的方法签名或 HTTP 行为。

本方案保留 `State any` 这一处开放输入,把 instructions 和 criteria 收敛为文本。将 Go 侧的 `Noul` 命名改为 `Binary`,协议仍发送 `noul`。响应保留可遍历的答案集合,并提供返回具体类型的方法。以下记录已确认的接口规则和相对于旧版草稿的能力调整。

## 调用方式

业务代码直接传入自己的结构体,不需要构造 `json.RawMessage`、通用 JSON 树或 `Content` 包装对象。下例使用已有的 `client` 和 `ctx`,展示当前 API:

```go
type ReviewState struct {
    UserRequest string `json:"user_request"`
    Policy      string `json:"policy"`
    ToolName    string `json:"tool_name"`
    Path        string `json:"path"`
}

state := ReviewState{
    UserRequest: "List the files under /workspace.",
    Policy:      "Check whether the proposed operation is within the user's request.",
    ToolName:    "list_directory",
    Path:        "/workspace",
}

resp, err := client.SystemOne(ctx, &systemone.Request{
    State: state,
    Questions: map[string]systemone.Question{
        "authorized": systemone.BinaryQuestion{
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add trpc-group/trpc-agent-go/internal/systemone/DESIGN.md@sha256:d1d79326e0187c74

The line at the top of this page pins the label git:20261010.5344490, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 10, 2026.

versioncommittedcommitsizeaudit
git:20261010.5344490 latest2026-10-10 5344490 21,159 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (21159 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-go · 1,906 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_giyohm2xsrx3vvn4
GET https://markdownregistry.com/api/v1/resolve?ref=trpc-group/trpc-agent-go/internal/systemone/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/d1d79326e0187c74e0448b22ca6ac0884d86b96ab20c1797c69a1008b0ccc30f

Your AI assistant 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.

Guides: what DESIGN.md is and how agents use it · which agent file does what.

More from trpc-group/trpc-agent-go

AGENTS.md AGENTS.md file
trpc-group/trpc-agent-go · AGENTS.md
git:20260720.41d2f05 · audit A · 1,906 stars
artifact_demo SKILL.md skill
trpc-group/trpc-agent-go · examples/agui/server/skill_artifacts/skills/artifact_demo/SKILL.md · Demo skill that writes an output file and persists it as an artifact.
git:20260303.3d67bd9 · audit A · 1,906 stars
weather-query SKILL.md skill
trpc-group/trpc-agent-go · examples/claudecode/.claude/skills/weather-query/SKILL.md · Answer weather queries with a fixed demo response.
git:20260210.f991cb4 · audit A · 1,906 stars
weather-query SKILL.md skill
trpc-group/trpc-agent-go · examples/codex/.agents/skills/weather-query/SKILL.md · Answer weather queries with a fixed demo response.
git:20260604.0f8ea6b · audit A · 1,906 stars
fanout-analysis SKILL.md skill
trpc-group/trpc-agent-go · examples/dynamicworkflow/skills/skills/fanout-analysis/SKILL.md · Use this workflow recipe when a question benefits from several independent perspectives followed by a single…
git:20260824.2303ec4 · audit A · 1,906 stars
quality-loop SKILL.md skill
trpc-group/trpc-agent-go · examples/dynamicworkflow/skills/skills/quality-loop/SKILL.md · Use this workflow recipe when a draft, plan, proposal, or other deliverable should be independently reviewed and…
git:20260824.2303ec4 · audit A · 1,906 stars
weather-query SKILL.md skill
trpc-group/trpc-agent-go · examples/evaluation/claudecode/.claude/skills/weather-query/SKILL.md · Answer weather queries with a fixed demo response.
git:20260226.3dbed7a · audit A · 1,906 stars
write-ok SKILL.md skill
trpc-group/trpc-agent-go · examples/evaluation/skill/skills/write-ok/SKILL.md · Write a deterministic OK file to out/ok.txt.
git:20260206.a5b44c2 · audit A · 1,906 stars
remote-http-mcp SKILL.md skill
trpc-group/trpc-agent-go · examples/mcpbroker/basic/skills/remote-http-mcp/SKILL.md · Connect to a remote streamable HTTP MCP service that exposes announcements and FAQ tools.
git:20260410.1e68463 · audit A · 1,906 stars
ocr SKILL.md skill
trpc-group/trpc-agent-go · examples/skill/skills/ocr/SKILL.md · Extract text from images using Tesseract OCR
git:20260121.295590e · audit A · 1,906 stars
whisper SKILL.md skill
trpc-group/trpc-agent-go · examples/skill/skills/whisper/SKILL.md · Transcribe audio files to text using OpenAI Whisper
git:20261104.278800a · audit A · 1,906 stars
plan_route SKILL.md skill
trpc-group/trpc-agent-go · examples/skilldynamicschema/skills/plan_route/SKILL.md · Plan a route and return distance + ETA (schema + deterministic result).
git:20260204.239a6a9 · audit A · 1,906 stars

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

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