Arrange

SkillMedia

Arrange is a skill that gives your AI a design language to work from. Once added, the interfaces and layouts your AI creates follow that guidance and look better as a result.

Available today. Use it from your connected AI after setup.

Add the skill, then ask your AI to build or improve an interface. It will apply the design guidance as it creates layouts for you.

Then ask your AI: use the Arrange skill

What your AI can do with it

  • Create interfaces that look better
  • Improve the layouts it produces
  • Follow a shared design language when building screens and pages
  • Apply design guidance while it works on interfaces

What this skill tells your AI

The instructions your AI receives, as published by yibie/supertag in skills/arrange/SKILL.md and read by ahel’s review.

把一个设计安排成 agent 能逐个完成的纵向切片。

读取

读取当前 feature 的 SPEC.md、项目 KERNEL.md(若存在)、相关 docs/spec-agents/WORKFLOW.mdCONTEXT.md、ADR、Protocol、Runbook、Lesson 和现有 Slice。只查已确认 SPEC 的范围;不要把尚未确认的想法提前拆成切片。

切片规则

  • 一个 Slice 对应一个新上下文可完成、可验证的结果。
  • 优先使用跨层的 tracer slice,而不是按文件或技术层机械拆分。
  • 明确 blocked_by;没有依赖的 Slice 才能进入 ready
  • 每个切片都指向 SPEC、相关 Action Contract 和验收证据。
  • 切片的验收必须在它自己的 Scope 内可达。验收要求写 Scope 之外的文件,是 拆分错误,回到 plan 重新划分边界,不要留给 do 去撞。
  • 每个切片必须写 authority:——本切片所碰业务规则的唯一权威模块,按 Kernel 的 Architecture boundaries 填。既不引入也不修改业务规则时写 n/a: <理由>字段缺失不是有效答案。做成必填而非条件必填是有意的: 它强制这个判断被写下来、可复核,而不是默默不做。 但要清楚它保证什么——它保证有一个答案,不保证答案是对的n/a 仍然把 「这算不算业务规则」的分类交回写切片的人,而 arrange 只读意图、读不到 diff,核不了这个分类。核它的地方是 check
  • Scope 含 do 不拥有的文件时,frontmatter 必须写 writer:do 拥有 Codelearn 拥有 KERNEL.mdCONTEXT.mdSTATUS.mdEVIDENCE.mddocs/{adr,protocols,runbooks,lessons}/capture 拥有 SPEC。
  • 被管项目中,安装进来的 doctrine 不属于任何动作,不能出现在任何切片的 Scope 里;需要改它就去改上游。
  • 发现语义冲突时停止安排,回到 plan;不要在 Slice 中偷偷改本体。

写入位置

.specs/<feature>/issues/NN-<slug>.md

最小模板:

# <id> <goal>

status: ready | blocked | doing | done | stale
blocked_by:
writer:            # Scope 含 do 不拥有的文件时必填
authority:         # 必填:本切片所碰规则的唯一权威模块,或 `n/a: <理由>`
spec_ref:
context_ref:
evidence_ref:

## Goal
## Scope
## Acceptance
## Verification
## Evidence

先向用户展示切片数量和依赖边,再写入文件;用户未确认拆分时只输出草案。evidence_ref 保持为空,直到 learn 完成验证记录。

完成条件

每个 Slice 都有可观察目标、边界、依赖、验收、验证方式和 authority:;每个 Slice 的验收在它自己的 Scope 内可达,越界写入的已声明 writer:;没有跨 Slice 的隐含前置条件。

Signals

GitHub stars
358
Forks
15
Last commit
Aug 2026
Hacker News mentions
6
Advanced
Catalog kind
skill
Gateway key
arrange
Source
github.com/yibie/supertag