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.

Install it, pinned
mdr add ylxmf2005/longrein/shape@git:20260923.8eb4b09

Pins 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

The exact contents, by fingerprint
mdr add ylxmf2005/longrein/shape@sha256:5d07b699efa33715

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6jgpvllqnhjwtwbo.svg)](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.

versioncommittedcommitsizeaudit
git:20260923.8eb4b09 latest2026-09-23 8eb4b09 4,235 BA view · diff
git:20260910.4546a3c2026-09-10 4546a3c 4,676 BA view · diff
git:20260821.26f216c2026-08-21 26f216c 4,700 BA view · diff
git:20260818.69b20e42026-08-18 69b20e4 3,453 BA view · diff
git:20260728.0720cda2026-07-28 0720cda 3,942 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

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

AGENTS.md AGENTS.md file
ylxmf2005/longrein · AGENTS.md
git:20260928.ff7811d · audit A · 11 stars
frontend-design SKILL.md skill
ylxmf2005/longrein · skills/frontend-design/SKILL.md · 新建、重设计或明显打磨网站、落地页、Web App、dashboard、编辑器、表单或前端组件时使用,包括"把这个页面做好看点""重做一下这个界面""做个落地页"这类说法。先定一个明确的视觉方向,再实现可运行的界面,并在真实浏览器里检查桌面…
git:20261001.490039e · audit A · 11 stars
review SKILL.md skill
ylxmf2005/longrein · skills/review/SKILL.md · 用户要求 review、CR,让你看看某个改动、PR、MR、设计或方案有没有问题,或者要判断它能不能合并、交付时使用。独立冷读准确的对象,查完影响范围,每个问题先试着推翻再报告,最后给出结论。只想弄懂改了什么时用…
git:20260923.8eb4b09 · audit A · 11 stars
test SKILL.md skill
ylxmf2005/longrein · skills/test/SKILL.md · 用户要求测试、E2E、回归、复现缺陷,或要判断一个功能、修复、迁移能不能交付时使用。先写测试计划,再从真实入口走到结果真正生效的地方执行,最后按计划逐项报告。写代码过程中跑一下单测、编译这类顺手检查不用;判断代码写得好不好用 review。
git:20260923.8eb4b09 · audit A · 11 stars
walkthrough SKILL.md skill
ylxmf2005/longrein · skills/walkthrough/SKILL.md · 用户想弄懂一段代码、diff、分支、MR、设计或一次故障,以便核对、接手或做决定时使用,例如"讲讲这个改动""带我过一遍这个模块""这个 PR 做了什么"。只问一个概念、一句话能答清时直接回答;要判断能不能合并时用 review。
git:20260923.8eb4b09 · audit A · 11 stars
writing-notes SKILL.md skill
ylxmf2005/longrein · skills/writing-notes/SKILL.md · 做出以后有人会问"为什么这样改"的技术决定时使用:选型、比较多个方案、架构调整、删减功能、复盘不显然的缺陷,或用户说"就用 X""为什么不用 Y"时;修改已有 Note 记录的模块时也使用。在 `.agents/notes/`…
git:20260923.8eb4b09 · audit A · 11 stars
writing-prompts SKILL.md skill
ylxmf2005/longrein · skills/writing-prompts/SKILL.md · 写、改写或审查 Prompt、AGENTS.md、Skill 与子代理任务说明时使用。从上下文怎样影响模型生成出发,判断每句话在引导什么、连带什么、稀释什么,重点改内容,排版只在影响理解时才动。
git:20260923.8eb4b09 · audit A · 11 stars

Every file in ylxmf2005/longrein

Other files named shape

shape SKILL.md skill
tdimino/claude-code-minoan · skills/design-media/shape/SKILL.md · Plan the UX and UI for a feature before writing code. Run a structured discovery interview, then produce a design brief…
git:20260515.94938c4 · audit A · 41 stars
shape SKILL.md skill
saadshahd/moo.md · hope/skills/shape/SKILL.md · Decide the technical path once the ask is clear. Use when the WHAT is confirmed but more than one way to build it…
git:20261016.b224a8c · audit A · 38 stars
shape SKILL.md skill
dbc-oduffy/coordinator-claude · skills/shape/SKILL.md · Converge with the PM on a problem's shape. Size first if unsized.
v1.0.0 · audit A · 6 stars
shape SKILL.md skill
chrislacey89/skills · shape/SKILL.md · Primary pipeline entry for structured requirements discovery. Use first when the problem, scope, or user needs are…
git:20261021.d548445 · audit A · 4 stars

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