design-solution

design-solution is a skill for Claude Code, Codex from zuoyebang/aiweave. It costs 84 tokens per session (2,468 once invoked), scanned A, original, Apache-2.0.

A technical-design guide that turns a short requirement into a written technical plan. It examines inputs and outputs, data, concurrent work, transactions, caching, reliability, latency, and overload handling.

In plain words
What is it for?
Use it to produce a placeholder-based technical requirements document for later documentation and coding work.
Why use it?
It helps expose important architecture decisions before implementation begins, especially when a requirement is incomplete or ambiguous.

Skill for Claude CodeCodex

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 skills/zuoyebang/aiweave/design-solution
Any agent
npx skills add zuoyebang/aiweave --skill design-solution
Clone the repo
git clone --depth 1 https://github.com/zuoyebang/aiweave

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for design-solution

README.md
[![agentmods](https://agentmods.dev/badge/skills/zuoyebang/aiweave/design-solution.svg)](https://agentmods.dev/skills/zuoyebang/aiweave/design-solution)
Your own site
<a href="https://agentmods.dev/skills/zuoyebang/aiweave/design-solution"><img src="https://agentmods.dev/badge/skills/zuoyebang/aiweave/design-solution.svg" alt="Measured on agentmods" height="20"></a>
Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,468 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.00084 $0.02468
Opus 5 $0.00042 $0.01234
Sonnet 5 $0.00017 $0.00494
Haiku 4.5 $0.00008 $0.00247

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

Security

Grade A, and why

design-solution 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 5d 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.

templates/skills/design-solution/SKILL.md · 113 lines

How it starts

The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.

根据 $ARGUMENTS 把一句需求过一遍 design-spec/ 七大决策视角,产出技术方案(TRD)。严格按以下步骤执行。

本 Skill 是 AIWeave 的【设计类】Skill(第 5 类 · A0 设计阶段)——design-spec/ 支柱的唯一执行器,位于 docs ↔ 代码生命周期的最上游。它不生成代码、不写 docs/,只产出"架构决策 + 落地索引"的 TRD;TRD 再进 A1 forward / B1 sync 落地为 docs/ 与代码。

公共步骤模板见 skills-spec/01_skill_authoring_guide.md §A-§E。本 Skill 不生成业务代码,第 5 步测试同步不适用(见末尾"测试同步")。

与 PRD→TRD 流的关系:本 Skill 聚焦"架构决策",产出 TRD 的技术决策主体。若上游已有 PRD→TRD 流程,可把本 Skill 作为其中"架构设计"环节,把七视角结论填入既有 TRD 的对应章节,而非另起一份。

第 0 步:拒绝规则与启用检查(公共模板见 §A,本 Skill 特定填充)

  • 拒绝规则(§A.1):需求触碰 BUILD_STATUS.md §0 中 🚫 暂不实现模块 → 立即停止
  • 启用检查:读 INDEX.md §0 采纳进度——design-spec/* 标 ⬜ 未启用 → 提示"本工程未启用 design-spec 决策方法论,可先启用或跳过本 Skill"
  • 输入完整性:需求过于模糊(无业务场景 / 无数据形态 / 无读写量级)→ 用苏格拉底式追问补齐最小决策输入:① 读多还是写多?② 数据规模量级?③ 一致性 / 延迟有无硬指标?

第 1 步:读取设计文档(公共必读见 §B)

1.1 读方法论(决策真相源):
    - design-spec/00(总纲 + 四大元方法 + 统一 lens 骨架 + §6 TRD 结构)
    - design-spec/01..07(七视角:IO / 数据建模 / 并发 / 事务 / 缓存 / 稳定性 / 尾延迟与过载)
1.2 读硬规则真相源(仅被引用,过决策树时按需查):
    - docs-spec/25(IO 三铁律) / 05(Schema) / 20(并发) / 21(事务) / 06(缓存) / 12(熔断) / 22(性能) / 24(跨服务) / 27(部署)
1.3 读本工程现状:
    - docs/INDEX.md §0(哪些规范已启用)+ docs/BUILD_STATUS.md(🚫 / 已实现)+ CLAUDE.md
1.4 读用户需求:$ARGUMENTS + 关联需求 / 业务文档(如有)

第 2 步:识别命中的决策视角(Skill 特定)

对需求逐一比对七视角各自的 §2 输入信号,列出命中视角清单

视角 命中信号(摘自各 lens §2)
IO(01) "对每个… / 同时要… / 高频读 / 高频写 / 纯追加 / 扇出调用"——只要涉及数据访问即强制命中
数据建模(02) 新实体 / 关系建模 / 高频检索 / 数据量增长 / 海量小映射 / 字段演进
并发(03) 共享状态 / 并行 fan-out / 后台协程 / 取消传播 / 嵌入式库并发
事务(04) 多写聚合 / 跨数据源 / 高频数值变更 / 重试场景 / 读写混杂判定
缓存(05) 读热点 / 计算昂贵 / 跨实例 / 一致性敏感 / 海量小映射 / 近静态小表 / 对外 ID
稳定性(06) 外部依赖 / 热路径 / 过载风险 / 多资源接入 / 凭据 / 危险开关
尾延迟与过载(07) P99≫P50 长尾 / 高扇出取最慢 / 共享资源排队 / 过载雪崩 / 重试放大 / 冷启尾延迟 / 严格端到端 SLA

第 3 步:逐视角过决策树产出结论(Skill 特定 / 核心)

每个命中视角,按其 §3 决策树 → §4 默认与升级 → §5 权衡 → §6 反模式 走一遍,得出该视角的决策结论:

对每个命中视角:
  ① 识别需求落入该视角的哪一种【形态】(§3 决策树叶子)
  ② 选定【方案】:默认选最简(§4 默认列),逐条核对升级触发是否成立 → 决定是否升级
  ③ 记录【关键权衡】(§5 矩阵)与【规避的反模式】(§6 速查 + grep 锚)
  ④ 标注该结论对应的【硬规则真相源】(如 IO → docs-spec/25 §2;只引用不复制)

Read the full file on GitHub · 113 lines

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. 5d ago First seen · 113 lines · 84 tokens per session scan A c3c4bd041c73

Subscribe to this mod's changes

design-solution is a skill published in the GitHub repository zuoyebang/aiweave (20 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 84 tokens to every session and 2,468 once invoked, about $0.0004 per session on Opus 5. 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.

Related

Other skills, from other repositories

build-teaql-app

Build or change a TeaQL application in Java, Rust, Go, Swift, Python, C#/.NET, or TypeScript, including Kotlin/JVM applications that consume Java-generated libraries. Mandatory order: first draft and save a complete KSML model, then verify the client and evaluate that saved model, repair it through repeated evaluation…

teaql/teaql-agent-kit · 112 tokens

build-executor

Govern implementation from an approved execution contract. Invoke when execution-contract.md is approved and the user wants disciplined build work, TDD execution, or guarded batch-by-batch implementation.

MageByte-Zero/spec-superflow · 39 tokens

workflow-start

Primary entry point for the spec-superflow state-machine workflow. Invoke when the user is inside an active spec-superflow change directory (look for .spec-superflow.yaml, changes/ /, proposal.md, specs/, design.md, tasks.md, or execution-contract.md) and asks to start, continue, resume, implement, plan, or figure out…

MageByte-Zero/spec-superflow · 125 tokens

release-archivist

Close out a spec-superflow change with verification, summary, and archive readiness. Invoke when implementation is complete, verification is underway, or the user asks for a final wrap-up.

MageByte-Zero/spec-superflow · 42 tokens

bug-investigator

Use when encountering any bug, test failure, or unexpected behavior during spec-superflow execution, before proposing fixes. Invoked automatically when build-executor hits a blockage.

MageByte-Zero/spec-superflow · 37 tokens

contract-builder

Convert approved planning artifacts into an execution contract. Invoke when the user wants to start building, asks to move from planning to implementation, or when execution-contract.md is missing or stale.

MageByte-Zero/spec-superflow · 39 tokens