prototype

A command for mapping how people move through a feature and how its screens respond to actions. It documents steps, success and failure paths, page states, form behaviour, gestures, and animations.

In plain words
What is it for?
Designing flows such as login or payment, defining loading, success, empty, and error states, and specifying validation, retries, navigation, gestures, and transitions.
Why use it?
It exposes missing steps and error cases before the feature is built, so the interface has clear behaviour for normal and problem situations.

Command for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/yezannnnn/agentgroup/prototype
Clone the repo
git clone --depth 1 https://github.com/yezannnnn/agentGroup

Made for: Claude Code.

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 679 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00679
Opus 5 $0.00000 $0.00340
Sonnet 5 $0.00000 $0.00136
Haiku 4.5 $0.00000 $0.00068

Measured 2d ago against content hash 665bf79bcd28, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

prototype scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

ella/.claude/commands/prototype.md · 121 lines

What it actually says

/prototype - 交互原型

设计用户交互流程和页面状态变化

使用方式

/prototype [功能描述]
/prototype 登录注册流程
/prototype 订单支付流程

执行步骤

1. 理解用户目标

  • 用户要完成什么任务?
  • 有哪些关键步骤?
  • 可能遇到什么问题?

2. 绘制流程图

用户流程: [功能名称]

[起点]
   ↓
[步骤1] ──失败──→ [错误处理]
   ↓ 成功              ↓
[步骤2]          [重试/返回]
   ↓
[完成]

3. 定义页面状态

## 页面状态

### [页面名]

| 状态 | 触发条件 | 界面表现 |
|------|----------|----------|
| 初始态 | 首次进入 | 表单为空 |
| 加载中 | 提交数据 | 按钮loading |
| 成功态 | 请求成功 | Toast提示 |
| 失败态 | 请求失败 | 错误提示 |
| 空状态 | 无数据 | 空状态插图 |

4. 设计交互细节

## 交互说明

### 表单交互
| 操作 | 反馈 |
|------|------|
| 输入时 | 实时校验,错误红框+提示 |
| 失焦时 | 完成校验 |
| 提交时 | 按钮loading,禁止重复点击 |

### 手势交互(移动端)
| 手势 | 效果 |
|------|------|
| 下拉 | 刷新数据 |
| 上滑 | 加载更多 |
| 左滑 | 删除操作 |

### 动画效果
| 场景 | 动画 | 时长 |
|------|------|------|
| 页面切换 | 左右滑动 | 300ms |
| 弹窗出现 | 底部弹起 | 250ms |
| Toast | 淡入淡出 | 200ms |

5. 异常处理

## 异常状态

| 异常 | 处理方式 |
|------|----------|
| 网络错误 | Toast提示"网络异常",可重试 |
| 服务器错误 | 错误页面,联系客服 |
| 登录过期 | 跳转登录页 |
| 无权限 | 提示无权限,返回上页 |

6. 输出原型文档

存储到 ../shared/designs/[功能名]-prototype.md

示例输出

# 交互原型 - 登录流程

## 用户流程

[打开App]
    ↓
[登录页] ─已登录─→ [首页]
    ↓ 未登录
[输入手机号]
    ↓
[获取验证码] ──失败──→ [提示错误,重新获取]
    ↓ 成功
[输入验证码]
    ↓
[登录验证] ──失败──→ [提示错误,重新输入]
    ↓ 成功
[首页]

## 页面状态
...

## 交互细节
...
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 121 lines · 0 tokens per session scan A 665bf79bcd28

Subscribe to this mod's changes

prototype is a command published in the GitHub repository yezannnnn/agentGroup (149 stars, last pushed 3mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 679 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.