Agent skill

Development Design

by Peiiii in Peiiii/nextclaw

通用开发生命周期的「方案设计」阶段 owner;当用户明确要求设计、风险达到 L3-L4,或用户可见 L2 功能存在真实方案空间时使用,负责冻结可执行设计,不负责实现、验证或发布。

MITAuto-check passed

Install Development Design

skills CLI
$ npx skills add Peiiii/nextclaw --skill development-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Peiiii/nextclaw development-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/development-design .claude/skills/development-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
development-design
GitHub stars
260
Token cost
~831 tokens
SKILL.md length
142 words
Files
6 (incl. references)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

通用开发生命周期的「方案设计」阶段 owner;当用户明确要求设计、风险达到 L3-L4,或用户可见 L2 功能存在真实方案空间时使用,负责冻结可执行设计,不负责实现、验证或发布。

  • Works in 5 steps: 写出入口到结果的最小完整路径,接口和字段须服务该路径。 → 区分单例、局部重复与跨场景不变量;抽象不高于证据。 → 复用主链路和最窄 owner;多场景共享变化边界才扩大范围。 → …
  • SKILL.md covers 目标, 产物分级, 计划门 and 设计合同, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Development Design is an agent skill from Peiiii/nextclaw. 通用开发生命周期的「方案设计」阶段 owner;当用户明确要求设计、风险达到 L3-L4,或用户可见 L2 功能存在真实方案空间时使用,负责冻结可执行设计,不负责实现、验证或发布。

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/adaptive-deliberation.md`, `references/architecture-principles.md` and `references/design-gap-scope.md`).

The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

Example prompts

  • “/development-design”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 写出入口到结果的最小完整路径,接口和字段须服务该路径。
  2. 区分单例、局部重复与跨场景不变量;抽象不高于证据。
  3. 复用主链路和最窄 owner;多场景共享变化边界才扩大范围。
  4. 恢复、权限、幂等完整;无消费者的基础设施不进入范围。
  5. 比较错误 owner/迁移债与无消费者抽象/验证面,选择净复杂度最低的结构。

What it can do on your machine

Read from SKILL.md and the folder at commit 973722e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Development Design loads about 831 tokens when it runs, and up to ~5.1k if it reads all its reference files. Until then it costs about 27 tokens; SKILL.md has 142 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~831
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Peiiii/nextclaw at commit 973722e, republished under its MIT licence (© Peiiii). 142 words, ~831 tokens.

Download SKILL.mdSave it as .claude/skills/development-design/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
development-design
description
通用开发生命周期的「方案设计」阶段 owner;当用户明确要求设计、风险达到 L3-L4,或用户可见 L2 功能存在真实方案空间时使用,负责冻结可执行设计,不负责实现、验证或发布。

Development Design

目标

回答“采用哪条主链路,为什么”。证据不足则返回调查。

实现前冻结验收与交付,不自行缩减用户结果。明确交付物与授权,给出 1–3 条“黄金验收”链路:目标 → 前提/真实入口 → 操作 → 响应 → 后续操作 → 结果 → 成败判定。入口、功能清单或技术调用链不能代替使用链路。标明等待成本、AI 自验证据及用户判断项;安装、测试和排障由 AI 承担。黄金验收覆盖完整标准但不替代 AI 自验;active contract 复用 IDs,按行为差异补矩阵。

验收适用性按用户行为与结果是否变化判断:没有新增 UI、只改底层或尚未发布,不构成豁免。纯内部重构且用户行为不变、规则维护或用户明确限定的源码/Review/原型交付,说明依据并提供匹配产物,不虚构产品使用链路。

稳定设计写入 docs/designs/YYYY-MM-DD-<topic>.design.md;局部方案可内联。大型交付的独立结果/决策须在实现前落盘;已有设计可引用,缺口和关键变更先补原文并链接历史。影响当前实现的选择先解决;分阶段须证明必要性。

有效合同形成或变化后,核对已有方案是否仍覆盖当前目标;受影响的设计、黄金验收和旧方案 Review 结论失效,补齐并复审后才能据此实现。未受影响部分继续复用,不把早期方案中的“未来扩展”当作新合同的范围决定。

产物分级

大型交付可按独立能力或独立审查需要拆专题设计:整体设计链接专题,专题引用上位约束并注明负责范围与适用状态,不复制全局合同。当前执行状态指向本项采用的设计和 Review 结论;拆文件不新增交付阶段。

输出设计结论与 design-document: required | not-required;feature/bugfix 共用产物门。

轻量设计限单 owner、无跨层合同/状态/兼容或真实分叉、局部可逆且不复用;写清问题、主链路、理由与验证。

出现以下任一情况,必须写入或更新稳定的 docs/designs 文档:

  • L3-L4,或跨 package、runtime、projection、transport、持久化边界;
  • 用户可见 L2 功能存在交互、信息架构或行为取舍;
  • 改变状态 owner、生命周期、不变量、协议、兼容、迁移、fallback 或失败恢复;
  • 有两个以上真实可行候选,需要记录选择与放弃理由;
  • 设计会跨会话、跨批次、交给他人实现,或预计成为后续判断依据。

L0 文档修正和 lifecycle 可跳过的 L1 单路径改动无需进入;不按 diff、工时或文件数决定是否建文档。

计划门

进入 Implementation 前输出 plan: required | not-required。单批无法可信闭环时使用开发执行 Plan 合同,否则不建;Plan 不是新 phase。

设计合同

只展开与当前任务相关的维度:

  • 大型交付记录“来源/版本 → 有效要求/ID → 设计位置 → 验证”,保留原始输入与全局约束;偏离写依据,未经授权不改用户结果。替代的旧输入保留溯源,原型不能只核对外观。
  • 用户或系统可观察问题;
  • producer、owner、consumer、已有约束与现有能力复用证据;
  • 真实分叉时的 2-4 个候选:用户价值、owner、复杂度、可逆性、验证成本及主链路;路径明显不虚构候选;
  • 状态、生命周期、不变量、失败/恢复、目录/公共入口/依赖边界;
  • 第三方框架/runtime/协议:冻结上游执行、线程、生命周期、资源与错误合同及产品保留职责;偏离须有必要性、官方依据、验证和退出条件;
  • 删除或禁止的平行路径,兼容/迁移/fallback 的必要性与退出条件;
  • 非目标与最小验证标准。

性能/成本影响选型时,沿同一代表性任务比较等待、资源和成本,区分实测、估算与未知;引用 active contract 门槛并给出昂贵分支验收路径。缺关键数据先做最小实验,不凭理论冻结结论;无相关取舍不加基准测试。

跨运行宿主、存储归属、能力目录或主要用户链路的设计,按功能设计关对账旧能力、用户目标和候选能力;关键入口、权限边界或验收路径未定时保持未就绪。

证据足够时冻结占优方案;仅当选择显著改变用户行为或范围且无法判断偏好时,才请求用户决定。

思考投入

目标、事实、根因或候选不确定,或属高风险决策时,读取自适应方案思考,选最低成本方法。简单可逆的惯例路径直接结论;不机械多方案,也不凭直觉冻结复杂设计。

过度设计门

任何设计进入 Design Ready 前必须完成一次抽象审计:

  1. 写出入口到结果的最小完整路径,接口和字段须服务该路径。
  2. 区分单例、局部重复与跨场景不变量;抽象不高于证据。
  3. 复用主链路和最窄 owner;多场景共享变化边界才扩大范围。
  4. 恢复、权限、幂等完整;无消费者的基础设施不进入范围。
  5. 比较错误 owner/迁移债与无消费者抽象/验证面,选择净复杂度最低的结构。

新增/改变抽象或公开闭集 variant 时必须读取架构设计原则,写清保留、删除、延后项;未来成本未付清不得 Design Ready。

涉及用户可用能力(含 CLI、SDK、后台自动化与集成)或交互时,读取功能设计关,先呈现用户链路再展开协议;纯内部且用户行为不变时说明不适用。

跨 runtime、journal、projection、transport 或 UI 的状态型设计补普通、运行、重试、取消、中断、刷新恢复和旧数据矩阵;局部无状态方案不填。

已有实现、验证、Review 或线上现象暴露未建模行为时,读取设计缺失的范围判定,区分实现偏差、局部合同、能力面和系统模型缺口,选防同类复发的最小范围;不按报错位置或 diff 定范围。

专项路由

每个设计决策最多选择一个当前 owner:

  • 通用 owner、生命周期、不变量、职责边界或抽象力度:读取架构设计原则;
  • 当前项目有领域、前端、目录、兼容、内容或发布专项合同时,只读取与本次设计决策直接相关的项目方法;不把项目方法复制进通用阶段。

专项方法仅按条件读取。

完成

冻结前用验收场景自审主链路、失败边界与抽象力度,关闭缺口;单路径简述结论,不虚构候选、默认委派或另建评审文档。

设计须形成统一模型,返回设计/plan、owner、主链路、验收标准、必要矩阵和非目标;standard 与正式 bugfix 设计交回总流程进入方案 Review,通过前不进入实现。本阶段的自审不替代该门。

新现象暴露模型缺口则返工设计;仅实现偏差不扩大。本阶段不编辑产品实现、验证、review、提交或发布。

© Peiiii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in .agents/skills/development-design of Peiiii/nextclaw.

  • SKILL.md
  • references/adaptive-deliberation.md
  • references/architecture-principles.md
  • references/design-gap-scope.md
  • references/feature-design-gate.md
  • references/nextclaw-kernel-owner-architecture.md

Open the folder on GitHubat commit 973722e

Compare with similar skills

Development Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Development Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Development Design this skillPeiiii/nextclaw260—~831Automated safety check: PassMIT
Agile Product Ownerdavila7/claude-code-templates32k2 repos~256Automated safety check: PassMIT
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Super Product Ownersyahiidkamil/Software-Engineer-AI-Agent-Atlas401—~7.9kAutomated safety check: PassNone
Find Lead Account Ownerzapier/gtm-cheat-codes342—~275Automated safety check: PassMIT
Owner VoiceAnastasiyaW/codex-claude-code-config154—~874Automated safety check: NotesMIT

Similar skills

  • Agile Product Owner

    davila7/claude-code-templates

    Agile product ownership toolkit for Senior Product Owner including INVEST-compliant user story generation, sprint planning, backlog management, and velocity tracking.

    32k GitHub starsUsed in 2 repos~256 tokens
    Product & Project ManagementAuto-check passed
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed
  • Super Product Owner

    syahiidkamil/Software-Engineer-AI-Agent-Atlas

    Complete Product Owner / Product Manager capability — a wiki-style knowledge map of product practice in active software development: the role and its boundaries, strategy cascade (vision → OKRs →…

    401 GitHub stars~7.9k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed
  • Find Lead Account Owner

    zapier/gtm-cheat-codes

    Official

    Resolve the right account owner for a lead using contact, company, and deal ownership evidence.

    342 GitHub stars~275 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Owner Voice

    AnastasiyaW/codex-claude-code-config

    Пишет и редактирует текст голосом владелицы — сообщение, письмо, пост, объяснение, урок, рабочий разбор, на русском и английском.

    154 GitHub stars~874 tokensUpdated yesterday
    Auto-check: notes
  • Kanban Md Principal Owner

    antopolskiy/kanban-md

    Review kanban-md feature requests, issues, PRs, and design proposals for product fit, domain-model growth, configurability, and compatibility.

    223 GitHub stars~1.7k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed

More from Peiiii/nextclaw

All 70 skills in this repo
  • Nextclaw Skin Studio

    Peiiii/nextclaw

    A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…

    260 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…

    260 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。

    260 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • UI UX Pro Max

    Peiiii/nextclaw

    A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…

    260 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Impeccable

    Peiiii/nextclaw

    A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…

    260 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Curate NextClaw skill resources, including OpenClaw and community sources.

    260 GitHub stars~479 tokensUpdated yesterday
    Auto-check passed

Questions about Development Design

What does Development Design do?

通用开发生命周期的「方案设计」阶段 owner;当用户明确要求设计、风险达到 L3-L4,或用户可见 L2 功能存在真实方案空间时使用,负责冻结可执行设计,不负责实现、验证或发布。. Development Design is an agent skill from Peiiii/nextclaw.

How do I install Development Design in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill development-design -a claude-code`. Or copy the skill folder (.agents/skills/development-design in Peiiii/nextclaw) into .claude/skills/development-design in your project. Claude Code loads it when a task matches its description.

How do I install Development Design in Codex?

Run `npx skills add Peiiii/nextclaw --skill development-design -a codex`. Or copy the skill folder (.agents/skills/development-design in Peiiii/nextclaw) into .agents/skills/development-design in your project. Codex loads it when a task matches its description.

Can I use Development Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Peiiii/nextclaw --skill development-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/development-design, .gemini/skills/development-design, .github/skills/development-design and .opencode/skills/development-design in your project.

What does Development Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Development Design is instructions for the agent only.

Does Development Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Development Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Development Design use?

Development Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Development Design use?

About 831 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.2k tokens, read only when the agent opens those files.

What are the alternatives to Development Design?

Skills that share tags, products or a category with Development Design: Agile Product Owner (davila7/claude-code-templates, 32k stars), Agile Product Owner (alirezarezvani/claude-skills, 28k stars), Super Product Owner (syahiidkamil/Software-Engineer-AI-Agent-Atlas, 401 stars) and Find Lead Account Owner (zapier/gtm-cheat-codes, 342 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Development Design?

Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 7, 2026.

Source: Peiiii/nextclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.