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 的前三章节(背景、目标、需求)。禁止在本阶段讨论设计方案——设计是 workflow-system-design skill 的职责。
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-requirements-clarification -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-requirements-clarification --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-requirements-clarification .claude/skills/workflow-requirements-clarification && 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-requirements-clarification" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-requirements-clarification into .claude/skills/workflow-requirements-clarification/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-requirements-clarification", 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-requirements-clarificationType 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-requirements-clarification -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-requirements-clarification --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-requirements-clarification .agents/skills/workflow-requirements-clarification && 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-requirements-clarification" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-requirements-clarification into .agents/skills/workflow-requirements-clarification/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-requirements-clarification", 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-requirements-clarification -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-requirements-clarification --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-requirements-clarification .cursor/skills/workflow-requirements-clarification && 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-requirements-clarification" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-requirements-clarification into .cursor/skills/workflow-requirements-clarification/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-requirements-clarification", 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-requirements-clarification--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-requirements-clarification -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-requirements-clarification --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-requirements-clarification .gemini/skills/workflow-requirements-clarification && 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-requirements-clarification" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-requirements-clarification into .gemini/skills/workflow-requirements-clarification/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-requirements-clarification", 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-requirements-clarificationInstalls 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-requirements-clarification -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-requirements-clarification .github/skills/workflow-requirements-clarification && 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-requirements-clarification" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-requirements-clarification into .github/skills/workflow-requirements-clarification/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-requirements-clarification", 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-requirements-clarification -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-requirements-clarification --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-requirements-clarification .opencode/skills/workflow-requirements-clarification && 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-requirements-clarification" agent skill from https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-requirements-clarification into .opencode/skills/workflow-requirements-clarification/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workflow-requirements-clarification", 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-requirements-clarification需求澄清。只负责明确"要解决什么问题",生成 spec.md 的前三章节(背景、目标、需求)。禁止在本阶段讨论设计方案——设计是 workflow-system-design skill 的职责。
Workflow Requirements Clarification is an agent skill from davidYichengWei/agentic-engineering-framework. 需求澄清。只负责明确"要解决什么问题",生成 spec.md 的前三章节(背景、目标、需求)。禁止在本阶段讨论设计方案——设计是 workflow-system-design skill 的职责。
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `reference/spec_template.md`).
It sits in Development. The repository describes itself as: 开箱即用、可按项目定制的 AI Coding Agent Skills 框架:提供通用 Workflow、可扩展的项目私有知识、自我学习闭环和问题排查能力,适配任意技术栈和工程场景。兼容主流 Coding Agent。 The licence is MIT.
7 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 (its code samples are bash).
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 Requirements Clarification loads about 1.2k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 333 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). 333 words, ~1,249 tokens.
.claude/skills/workflow-requirements-clarification/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 必须自己调研,不问用户。
向用户询问需求信息时,采用苏格拉底式提问——刨根问底,理解问题本质:
| 技巧 | 说明 | 示例 |
|---|---|---|
| 追问 Why | 不接受表面答案,追问到问题本质 | 用户:"加个缓存" → AI:"为什么需要缓存?慢到什么程度?目标是多少?" |
| 指出矛盾 | 发现用户表述中的矛盾时,引导用户澄清 | 用户:"要高并发,但不能改接口" → AI:"异步化会改变接口语义,这两个目标是否冲突?" |
| 揭示遗漏 | 引导用户思考未考虑的场景 | AI:"你考虑过 X 失败的情况吗?" |
bp-distributed-systems 等)spec.md 不存在或需求章节为空| AI 应该做 | AI 不应该做 |
|---|---|
| 提问,追问 Why | 未经请求就给答案 |
| 指出矛盾或遗漏 | 未追问清楚就生成内容 |
| 质疑不清晰的表述 | 跳过追问直接给建议 |
| 用户请求时生成内容 | 生成后不询问用户意见 |
1. 说明当前阶段和目标
2. 提出一个开放式问题(让用户思考)
3. 等待用户回答
4. 评估用户回答:
- 清晰完整 → 复述确认,进入下一问题
- 模糊 → 追问具体含义
- 有矛盾 → 指出矛盾
- 有遗漏 → 引导思考
5. 用户澄清后,再次确认| 复杂度 | 信号 | 处理方式 |
|---|---|---|
| 简单 | bug fix、配置调整、单点修改 | 不创建 spec,1-2 轮对话后直接进入 code-generation |
| 中等 | 涉及多文件、单模块功能 | 创建 spec |
| 复杂 | 跨模块、新特性、架构变更 | 创建 spec |
中等及以上:立即创建目录并复制模板:
mkdir -p docs/design-docs/<module>/<feature>/
cp skills/workflow-requirements-clarification/reference/spec_template.md \
docs/design-docs/<module>/<feature>/spec.md路径规则:根据功能所属模块确定。文件名必须是 spec.md。
目标:理解现有实现,不询问用户
AI 操作:
codebase-researcher subagent 深度调研相关代码(模块结构、接口、依赖关系、数据流)向用户汇报(必须):
我先调研了一下相关代码:
**相关模块**:
- [文件路径1]: [职责说明]
- [文件路径2]: [职责说明]
**现有实现**:
[概述当前的实现方式、数据流、关键接口]
**技术约束**:
- [约束1,如使用的框架、协议]
- [约束2,如已有的接口规范]
请确认我的理解是否正确?有遗漏或错误的地方吗?结束条件:用户确认理解正确。必须等用户确认后才能进入 Step 2。
实时更新 spec:用户确认后,更新 spec.md 的 1.2 现状分析 和 1.3 主要使用场景。
目标:让用户说清楚"要解决什么问题"
开场白:
请描述一下:**现在遇到了什么问题?这个问题带来了什么影响?**追问方向:
结束条件:用户能清晰回答"要解决什么问题",AI 复述确认无误。
实时更新 spec:确认后,更新 spec.md 的 1.1 问题描述。
目标:让用户定义"成功标准"和"不做什么"
开场白:
好的,问题我理解了。
接下来请你想一下:
- **这次的目标是什么?怎么算做完了?**
- **有什么是明确不做的?**追问方向:
结束条件:用户给出明确、可衡量的目标和边界。
实时更新 spec:确认后,更新 spec.md 的 2. 目标 和 2.1 非目标。
目标:让用户说清楚"具体要做哪些功能来达成目标"
开场白:
目标明确了。
接下来请你描述一下:**具体需要哪些功能来达成这个目标?**追问方向:
结束条件:用户给出具体的功能列表,AI 复述确认无误。
实时更新 spec:确认后,更新 spec.md 的 3.1 功能性需求。
目标:引导用户思考隐藏的约束条件
分布式系统场景:如果需求涉及网络通信、多节点协调、数据一致性、故障恢复,必须加载
bp-distributed-systemsSkill。
开场白:
最后想请你考虑一下:**有没有隐藏的约束条件?**
比如:性能要求、接口兼容性、升级回滚策略?非功能性需求 checklist(AI 根据需求场景判断是否相关,相关则询问,并给出具体例子帮助用户理解):
| 类别 | 何时询问 | 引导问题 | 具体例子 |
|---|---|---|---|
| 性能 | 涉及热路径、数据处理 | 延迟/吞吐量要求?并发量预估? | "比如:单次请求延迟 < 10ms?支持 1000 QPS?" |
| 可用性 | 涉及关键链路 | SLA 要求?故障降级方案? | "比如:节点挂了怎么办?还能继续提供服务吗?" |
| 一致性 | 涉及分布式、事务 | 强一致/最终一致?隔离级别? | "比如:并发写同一行时谁赢?读能看到正在写的数据吗?多个操作需要原子性吗?跨节点读写一致吗?" |
| 兼容性 | 涉及接口、协议变更 | API 是否需向后兼容? | "比如:新增字段后,旧客户端解析会报错吗?旧版本写入的数据新版本能读吗?" |
| 升级 | 涉及持久化格式变更 | 滚动升级安全吗?需要数据迁移吗? | "比如:新旧版本混部时数据互通吗?" |
| 回滚 | 有持久化变更 | 能回滚吗?回滚后数据丢失吗? | "比如:升级失败回滚到旧版本,新写入的数据还在吗?" |
| 安全 | 涉及权限、敏感数据 | 权限控制?数据脱敏?审计日志? | "比如:谁能调用这个接口?操作需要记录吗?" |
| 可观测 | 新功能、复杂逻辑 | 需要哪些监控指标?告警阈值? | "比如:需要监控成功率、延迟分布吗?什么情况告警?" |
| 资源 | 涉及大数据量处理 | 内存/CPU/磁盘限制? | "比如:单次请求最多用多少内存?" |
| 可扩展 | 涉及数据增长 | 数据量增长预期?水平扩展? | "比如:数据量翻倍时性能会怎样?" |
| 持久性 | 涉及数据存储 | 允许丢数据吗?持久化策略? | "比如:断电重启后数据还在吗?" |
结束条件:用户确认关键约束,或明确表示"没有其他约束"。
实时更新 spec:确认后,更新 spec.md 的 3.2 非功能性需求。
目标:回顾 spec 前三章节的完整性,确认无遗漏。
操作:
结束语:
spec.md 前三章节已完成:docs/design-docs/<module>/<feature>/spec.md
(已填写:1. 背景、2. 目标、3. 需求)
如果准备好了,说"开始设计"进入 system design 阶段。docs/design-docs/<module>/<feature>/spec.mdworkflow-system-design skill 负责| ❌ 错误做法 | ✅ 正确做法 |
|---|---|
| 问用户"现有实现是怎样的" | AI 自己读代码调研 |
| 从头创建 spec.md | 必须用 cp 复制模板 |
| 生成到宿主工具私有目录 | 生成到 docs/design-docs/ |
文件名 xxx-spec.md | 文件名必须是 spec.md |
| 填写设计方案章节 | 只填前三章节 |
| 一次问多个问题 | 每轮只问一个核心问题 |
| 所有步骤完成后才写 spec | 每步结束后实时更新对应章节 |
© 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-requirements-clarification of davidYichengWei/agentic-engineering-framework.
Open the folder on GitHubat commit 1f7ac0f
Workflow Requirements Clarification 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 Requirements Clarification this skilldavidYichengWei/agentic-engineering-framework | 158 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Vercel Composition Patternssupabase/supabase | 111k | 58 repos | ~726 | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 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 的前三章节(背景、目标、需求)。禁止在本阶段讨论设计方案——设计是 workflow-system-design skill 的职责。. Workflow Requirements Clarification is an agent skill from davidYichengWei/agentic-engineering-framework.
Workflow Requirements Clarification fits situations like: development work in your project.
Run `npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-requirements-clarification -a claude-code`. Or copy the skill folder (skills/workflow-requirements-clarification in davidYichengWei/agentic-engineering-framework) into .claude/skills/workflow-requirements-clarification in your project. Claude Code loads it when a task matches its description.
Run `npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-requirements-clarification -a codex`. Or copy the skill folder (skills/workflow-requirements-clarification in davidYichengWei/agentic-engineering-framework) into .agents/skills/workflow-requirements-clarification 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-requirements-clarification -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-requirements-clarification, .gemini/skills/workflow-requirements-clarification, .github/skills/workflow-requirements-clarification and .opencode/skills/workflow-requirements-clarification in your project.
SKILL.md names no scripts, command-line tools or credentials: Workflow Requirements Clarification 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 Requirements Clarification is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.2k tokens (SKILL.md is roughly 5k 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 Requirements Clarification: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k 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.