loop-design-check SKILL.md skillA
loop-design-check from qshanx/docs-governance is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add qshanx/docs-governance/loop-design-check@git:20261011.d0306dcPins git:20261011.d0306dc in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- qshanx/docs-governance
- Path
skills/engineering/loop-design-check/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261011.d0306dc, committed Oct 11, 2026
- Size
- 9,611 bytes
- Repository stars
- 218
- License
- MIT
把一个任务"写成"一个目标导向的 loop，并"检查"这个 loop 写得对不对、会不会跑飞——防止空转烧钱 / Goodhart 作弊 / 把错的干到底。两个动作：① 写 loop（先做减法判该不该建 → 定可判定目标 → 选回路类型 → 选骨架）② 体检 loop（过五个崩法 + 可判定性 + 边界 + 降级 + judge 独立 + 判断留人红线）。中文触发：写 loop、设计 loop、做一个 loop、把任务变 loop、agent 自动循环、检查 loop 对不对、loop 体检、loop 会不会跑飞、loop 空转烧钱、loop 作弊、目标导向循环、可判定目标、五个崩法、plan build judge、文档驱动派活、该不该建 loop。English triggers: design an agent loop, write a loop, check a loop, loop review, prevent runaway loop, goal-oriented loop, decidable goal, plan build judge.
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
# Loop 设计 + 体检 > **一句话前提**：LLM 本身是前馈系统（prompt 进 → token 出，跨轮之间没有内建的"朝目标纠偏"能力）。要它*表现得*像目标导向系统，得在外面包一条反馈回路（loop）。这个 skill 帮你**写对**这条回路、并**体检**它不会跑飞。 ## 何时用 / 不用 **用**： - 想把一个重复任务交给 agent 自动反复跑（写完测、测完修、改完验…）。 - 已经写了个 loop，但担心它空转 / 作弊 / 跑飞，要体检。 **不用**： - 一次性任务 → 直接做，别套循环。 - 纯定时提醒 / 轮询 → 用 `/loop` 命令即可，不需要"设计"。 - "怎么搭循环的工程架构（管道→DAG、长跑恢复）" → 那是机制层，看 `autonomous-loops` / `continuous-agent-loop`。**本 skill 只管"目标定得对不对、会不会跑飞"这层判断，不重写机制。** ## 红线前提：两层反馈（先记死，违反则全盘皆输） | 层 | 谁管 | 干什么 | |---|---|---| | **执行层**（低层） | 机器 / agent | 测"离字面目标还差多少"，死磕缩到 0。机器很强。 | | **判断层**（高层） | **人** | 判"这目标本身对不对、要不要改、要不要停"。机器跳不出自己的回路质疑目标。 | > 空调能反馈"离 26 度差多少"，但你发烧想要 28 度时，它判断不了"26 度对不对"——只会死磕 26。**"今天该设几度"永远是人。** > 把判断 / 验收 / 最后一格交给机器 = 撤掉高层反馈 = 机器照着没人质疑的目标又快又狠地狂奔 → 出错。 --- ## 动作一：写一个 loop（5 步） ### 步 0 · 先做减法：该不该建？（四条件入场券，缺一票否决） ① 任务每周以上重复 ② 验证能自动化 ③ token 预算扛得住 ④ agent 有"能真跑起来看结果"的工具 任一不满足 → **别建 loop**，手动做或换别的方式。 > 卡住大多数人的不是"会不会写循环"，是"你那个仓库配不配得上一个循环"。配得上的仓库 = 有对账基线（golden sample / 上游合计）+ 单测 + lint 守护。**配不上循环的仓库，循环只会放大错。** ### 步 1 · 定一个"可判定"的目标（最吃劲，loop 成败全在这） 整条回路靠"比较器"那句"达成了吗"。**比较器能不能干活，全看你给的退出条件能不能被机器清楚判 yes/no。** - ❌ 模糊（"把这个做好""写高级点"）→ 比较器没法判 → 要么永远不放行（卡死反复重试），要么瞎放行/瞎拦截。 …
Read the whole file at its exact version.
How to install
mdr add qshanx/docs-governance/loop-design-check@sha256:711e70d4d3301045The line at the top of this page pins the label git:20261011.d0306dc, 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.
[](https://markdownregistry.com/a/art_sug2revwq6wbhu7v)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 11, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (9611 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
qshanx/docs-governance · 218 stars · license MIT · pushed 2026-10-16 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_sug2revwq6wbhu7v GET https://markdownregistry.com/api/v1/resolve?ref=qshanx/docs-governance/loop-design-check GET https://markdownregistry.com/api/v1/blob/711e70d4d3301045b5c8c24350177310281fd92dbcbe7b536077ffd78b35b38b
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: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.