Vercel Composition Patterns
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
Agent skill
by davidYichengWei in davidYichengWei/agentic-engineering-framework
系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-design --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/workflow-system-design .claude/skills/workflow-system-design && rm -rf skills-srcUse ~/.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/
Install the "workflow-system-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design into .claude/skills/workflow-system-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-system-design", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-designType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/workflow-system-design .agents/skills/workflow-system-design && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "workflow-system-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design into .agents/skills/workflow-system-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-system-design", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/workflow-system-design .cursor/skills/workflow-system-design && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "workflow-system-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design into .cursor/skills/workflow-system-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-system-design", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/davidYichengWei/agentic-engineering-framework.git --path skills/workflow-system-design--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/workflow-system-design .gemini/skills/workflow-system-design && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "workflow-system-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design into .gemini/skills/workflow-system-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-system-design", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-designInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/workflow-system-design .github/skills/workflow-system-design && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "workflow-system-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design into .github/skills/workflow-system-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-system-design", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/davidYichengWei/agentic-engineering-framework.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/workflow-system-design .opencode/skills/workflow-system-design && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "workflow-system-design" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design into .opencode/skills/workflow-system-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-system-design", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
workflow-system-design系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。
Workflow System Design is an agent skill from davidYichengWei/agentic-engineering-framework. 系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `reference/section-guide.md`).
It sits in Development. The repository describes itself as: 开箱即用、可按项目定制的 AI Coding Agent Skills 框架:提供通用 Workflow、可扩展的项目私有知识、自我学习闭环和问题排查能力,适配任意技术栈和工程场景。兼容主流 Coding Agent。 The licence is MIT.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 1f7ac0f. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Workflow System Design loads about 1k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 257 words of instructions outside code blocks.
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.
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.
The full file from davidYichengWei/agentic-engineering-framework at commit 1f7ac0f, republished under its MIT licence (© davidYichengWei). 257 words, ~1,033 tokens.
.claude/skills/workflow-system-design/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.AI 负责调研代码背景,用户主导设计决策。
| AI 自己调研(读代码) | 与用户讨论 |
|---|---|
| 现有模块结构和职责 | 设计方向和权衡取舍 |
| 已有接口和数据结构 | 接口变更决策 |
| 依赖关系和调用链 | 模块划分决策 |
| 技术约束(框架、协议) | 性能/可维护性权衡 |
规则:如果信息可以从 codebase 获取,AI 必须自己调研,不问用户。
AI 通过提问帮助用户发现问题和权衡:
| 场景 | AI 行为 |
|---|---|
| 用户正在思考/描述设计 | 只提问和质疑,不给方案 |
| 用户明确请求帮助 | 先追问确认理解 → 加载规范 → 生成建议 → 询问意见 |
| 用户卡住(多轮无进展) | 提供思考方向,仍以问题形式呈现 |
| 第 6 节业界调研 | AI 主动搜索并提供业界方案作为参考 |
spec.md 已存在且第 1-3 节(背景、目标、需求)完整workflow-requirements-clarification Skillworkflow-requirements-clarification 完成后用户确认进入设计阶段在讨论到相关 section 时才加载对应规范,不要在开始时一次性加载所有规范:
| 规范 | 何时加载 |
|---|---|
bp-architecture-design Skill | 讨论 4.1 方案概览时加载 |
bp-component-design Skill | 讨论 4.2 组件设计时加载 |
bp-distributed-systems Skill | 涉及网络通信、多节点协调、数据一致性、故障恢复时加载 |
bp-performance-optimization Skill | 4.3 核心逻辑完成后加载,优化性能方面的设计考量 |
workflow-test-generation Skill | 讨论 7. 测试计划时加载 |
| AI 应该做 | AI 不应该做 |
|---|---|
| 提供思考框架和维度 | 未经请求就给设计方案 |
| 质疑设计的合理性 | 未追问清楚就生成内容 |
| 指出潜在风险和权衡 | 跳过追问直接给设计 |
| 用户请求时生成设计建议 | 生成后不询问用户意见 |
1. 说明当前 section 和目标
2. 提供思考框架(要考虑哪些维度)
3. 请用户描述设计想法
4. 等待用户回答
5. 评估用户设计:
- 合理完整 → 复述确认,进入下一 section
- 有遗漏 → 引导:"你考虑过 X 情况吗?"
- 有风险 → 质疑:"这样做可能会导致 Y,你怎么看?"
- 有权衡 → 追问:"A 和 B 你选择 A,为什么?"
6. 用户完善后,复述确认,更新 spec.md提供思考框架(不是给答案):
AI:"设计架构时,通常需要考虑:
- 模块如何划分?职责边界在哪?
- 模块之间的依赖关系是什么?
- 数据流是怎样的?
请描述一下你的整体设计思路。"质疑潜在风险:
用户:"我打算用单例模式"
AI:"单例在多线程环境下可能有问题。这个模块会被多线程访问吗?"用户:"4.1 方案概览我不太有思路,你能给我一些建议吗?"
AI:(先追问)
"好的。在给你建议之前,我想先确认几点:
- 这个功能是新增模块,还是在现有模块上扩展?
- 对改动范围有限制吗?
- 性能是关键考量吗?"
用户:"在现有模块扩展,尽量不改核心路径,性能很重要"
AI:(加载规范,生成建议)
"基于你的约束,我有几个方向供你参考:
**方向 1:Plugin 模式**
- 优点:不改核心路径,隔离性好
- 缺点:可能有间接调用开销
**方向 2:条件分支**
- 优点:简单直接
- 缺点:会修改现有代码路径
你倾向于哪个方向?或者有其他想法?"目标:理解现有实现 + 确认对需求的理解
AI 操作:
codebase-researcher subagent 深度调研相关代码(模块结构、接口、依赖链、技术约束)向用户汇报(必须):
我已读完 spec.md 并调研了相关代码:
**需求理解**:
- 问题:[复述 spec.md 中的问题]
- 目标:[复述目标]
- 关键约束:[复述非功能需求]
**代码调研**:
- 相关模块:[列出发现的模块]
- 现有接口:[列出相关接口]
- 技术约束:[发现的约束]
请确认我的理解是否正确?有遗漏或错误的地方吗?结束条件:用户确认理解正确。必须等用户确认后才能进入设计讨论。
好的,我们现在进入 **系统设计** 阶段,从 **4.1 方案概览** 开始。
请描述一下你的整体设计思路。每轮只讨论一个 section。详细的 section 引导模式参见 reference/section-guide.md。
判断 section 是否适用:
AI:"4.2.3 数据模型这个 section,你的需求涉及新的数据结构吗?不涉及可以跳过。"用户跳过时,在 spec.md 标注 N/A - 本需求不适用。
每个 section 完成后:
| ❌ 错误做法 | ✅ 正确做法 |
|---|---|
| 问用户"现有实现是怎样的" | AI 自己读代码调研 |
| 直接开始设计讨论 | 先展示需求摘要 + 代码调研,确认后再开始 |
| 用户没请求就给方案 | 先提问,等用户请求帮助再给建议 |
| 生成设计后当作最终方案 | 询问"你倾向于哪个方向?" |
| 用户说什么就同意什么 | 质疑潜在问题 |
| 4.1 讨论中写入具体调用点/函数签名 | 记录备忘,进入 4.3 时再写入 |
| 4.1 未完成就开始写 4.2/4.3 | 严格按 4.1 → 4.2 → 4.3 顺序逐级完成 |
spec.md 设计部分已完成。
你可以:
- 说"开始编码"进入 code generation 阶段
- 说"先写测试"进入 TDD 模式
- 如果某个 section 需要修改,告诉我具体哪个© davidYichengWei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in skills/workflow-system-design of davidYichengWei/agentic-engineering-framework.
Open the folder on GitHubat commit 1f7ac0f
Workflow System 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Workflow System Design this skilldavidYichengWei/agentic-engineering-framework | 158 | — | ~1k | Automated safety check: Pass | MIT | |
| Vercel Composition Patternssupabase/supabase | 111k | 59 repos | ~726 | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 296k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Typescript Advanced Typesrolling-scopes/rsschool-app | 10k | 25 repos | ~4.2k | Automated safety check: Pass | MPL-2.0 | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 5 repos | ~1.1k | Automated safety check: Pass | MIT |
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
davidYichengWei/agentic-engineering-framework
Gives architecture design principles for system design discussions and code review: module boundaries, dependency direction, data ownership and interface rules, plus a checklist.
davidYichengWei/agentic-engineering-framework
A checklist of language-neutral rules for writing and reviewing code: naming, function design, control flow, resource safety, comments and logging.
davidYichengWei/agentic-engineering-framework
Chinese-language checklists for component-level design: class and module structure, public interfaces, data models, concurrency and error handling.
davidYichengWei/agentic-engineering-framework
Chinese-language guide to writing and improving SKILL.md files: frontmatter rules, concise writing, progressive disclosure, common patterns and a pre-release checklist.
davidYichengWei/agentic-engineering-framework
Turns mistakes you correct into proposed updates to persistent Rules and Skills so the same error does not recur in later sessions, triggered automatically or with /reflect.
davidYichengWei/agentic-engineering-framework
Diagnoses compile errors, runtime exceptions, failing tests, pipeline failures and production alerts from code and logs, giving a root cause before any fix.
Categories
系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。. Workflow System Design is an agent skill from davidYichengWei/agentic-engineering-framework.
Workflow System Design fits situations like: development work in your project.
Run `npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a claude-code`. Or copy the skill folder (skills/workflow-system-design in davidYichengWei/agentic-engineering-framework) into .claude/skills/workflow-system-design in your project. Claude Code loads it when a task matches its description.
Run `npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a codex`. Or copy the skill folder (skills/workflow-system-design in davidYichengWei/agentic-engineering-framework) into .agents/skills/workflow-system-design in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-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/workflow-system-design, .gemini/skills/workflow-system-design, .github/skills/workflow-system-design and .opencode/skills/workflow-system-design in your project.
SKILL.md names no scripts, command-line tools or credentials: Workflow System Design is instructions for the agent only.
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.
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.
Workflow System Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Workflow System Design: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
davidYichengWei (a GitHub user) maintains it in davidYichengWei/agentic-engineering-framework, which has 158 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on March 25, 2026.
Source: davidYichengWei/agentic-engineering-framework on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.