shape SKILL.md skillA
shape from ylxmf2005/longrein is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ylxmf2005/longrein/shape@git:20260923.8eb4b09Pins git:20260923.8eb4b09 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ylxmf2005/longrein
- Path
skills/shape/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260923.8eb4b09, committed Sep 23, 2026
- First version recorded
- Jul 28, 2026
- Size
- 4,235 bytes
- Repository stars
- 11
- License
- none declared
用户要求 Shape、输入 /shape,或想先对齐方案、由自己做关键决定再动手时使用。先调查现实,摆出选项和代价,逐轮只问现在能决定的问题,用户做出关键决定后再进入实现。用户没有提出时不用,即使目标还不确定,也只建议用户用 Shape。.
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
# shape Shape 是规划里最深的一档。目标或关键前提还靠不住时,先让现实把事实、矛盾、可选方案和代价摆出来,再收敛方向。现实指代码、运行现场、数据和用户的实际使用;用户的描述和已有文档是线索,不能代替它们。 ## 调查:事实自己查,决定交给用户 能从代码、运行现场、文档和工具查明的事实,自己查清,不拿去问用户。价值、偏好、范围、能接受的风险和授权由用户决定。 开始时放开看:多看几种可能,不急着定形,也不要让最先发现的问题框住后面的调查。继续合理调查已经不会改变结论时,再开始收敛。调查可以看得宽,做事的范围不跟着扩大。证据推翻了原来的方向时,直接说出影响,不悄悄改写用户的目标。 ## 提问:只问现在能决定的 把未决事项看成有先后依赖的决策树。前置决定还没定的分支先不问;现在就能决定、又会改变方向的问题,放在同一轮问。每个问题讲清背景,给出你的推荐和各个选项的代价,默认用户没读过相关代码。 用户回答后,重新看哪些问题因此消失、哪些新出现,不按旧的问题清单往下走。用户说"不知道"不等于同意,把它记成一个明确的未知,并说明它影响什么。 ## 收敛:让下一步不用猜 方向可以承诺时,这几件事都能写成具体的句子:目标(完成后能观察到什么)、范围、不做什么、验收标准,以及还没决定的问题。把它们简短地给用户看;关键决定由用户做出后进入实现,按工作模式选的执行档继续。不依赖未决问题的工作可以先做。 只要实现时还得猜需求、系统设计、公共契约或迁移路线,就把对应的部分补完。局部、结构清楚的任务不为形式写文档。 ## 保存:shape.md Shape 的产出是一份 `shape.md`,写到 `.agents/tasks/<日期>-<主题>/shape.md`,调查开始后就建立,随调查和用户的决定持续更新。只有用户明确说只想讨论时,才只在对话里进行。这个任务后续的测试报告等文件也放在同一个目录,实现、test 和 review 都以它为准。 ```markdown # <任务> ## 原始请求 用户的原话,或不增加意图的整理,注明来源。 ## 现状 已查明的代码、运行状态、环境和约束。没查的写"未查",查过确认不存在的才写"无"。 ## 目标 完成后能观察到什么。 ## 范围 做什么,不做什么。 ## 验收标准 要观察到的结果,以及证明它需要的证据。 ## 决定 用户已经做出的决定和理由;仍未决定的问题,以及它影响什么。 ## 方案 实现时需要、上面几节写不下的内容,例如根因诊断、需求细节、设计、接口契约、迁移步骤或执行计划。只写这次用得上的部分,按需加小标题。 ``` …
Read the whole file at its exact version.
How to install
mdr add ylxmf2005/longrein/shape@sha256:5d07b699efa33715The line at the top of this page pins the label git:20260923.8eb4b09, 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_6jgpvllqnhjwtwbo)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 28, 2026 and Sep 23, 2026, about one every 14 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260923.8eb4b09 latest | 2026-09-23 | 8eb4b09 | 4,235 B | A | view · diff |
| git:20260910.4546a3c | 2026-09-10 | 4546a3c | 4,676 B | A | view · diff |
| git:20260821.26f216c | 2026-08-21 | 26f216c | 4,700 B | A | view · diff |
| git:20260818.69b20e4 | 2026-08-18 | 69b20e4 | 3,453 B | A | view · diff |
| git:20260728.0720cda | 2026-07-28 | 0720cda | 3,942 B | A | view |
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 (4235 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
ylxmf2005/longrein · 11 stars · license none declared · pushed 2026-10-01 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6jgpvllqnhjwtwbo GET https://markdownregistry.com/api/v1/resolve?ref=ylxmf2005/longrein/shape GET https://markdownregistry.com/api/v1/blob/5d07b699efa33715a0969f230e415b1435d6cd28e9f4a0d5f5dd5d8186360e4d
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.
More from ylxmf2005/longrein
Every file in ylxmf2005/longrein