Agent skill

Workflow System Design

by davidYichengWei in davidYichengWei/agentic-engineering-framework

系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。

MITAuto-check passedDevelopment

Install Workflow System Design

skills CLI
$ npx skills add davidYichengWei/agentic-engineering-framework --skill workflow-system-design -a claude-code

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

GitHub CLI
$ gh skill install davidYichengWei/agentic-engineering-framework workflow-system-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/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-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
workflow-system-design
GitHub stars
158
Token cost
~1k tokens
SKILL.md length
257 words
Files
2
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。

  • Works in 4 steps: 代码调研 + 需求摘要(AI 自主完成) → 开始设计讨论 → 按 section 顺序讨论 → …
  • Development work in your project
  • SKILL.md covers 核心定位, 前置条件, 触发条件 and 规范加载(按需), plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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.

When your agent uses it

  • Development work in your project

Example prompts

  • “/workflow-system-design”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 代码调研 + 需求摘要(AI 自主完成)
  2. 开始设计讨论
  3. 按 section 顺序讨论
  4. 更新 spec.md

What it can do on your machine

Read from SKILL.md and the folder at commit 1f7ac0f. 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

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.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~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 davidYichengWei/agentic-engineering-framework at commit 1f7ac0f, republished under its MIT licence (© davidYichengWei). 257 words, ~1,033 tokens.

Download SKILL.mdSave it as .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.
name
workflow-system-design
description
系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。

系统设计

核心定位

AI 负责调研代码背景,用户主导设计决策。

AI 职责划分
AI 自己调研(读代码)与用户讨论
现有模块结构和职责设计方向和权衡取舍
已有接口和数据结构接口变更决策
依赖关系和调用链模块划分决策
技术约束(框架、协议)性能/可维护性权衡

规则:如果信息可以从 codebase 获取,AI 必须自己调研,不问用户。

苏格拉底式导师

AI 通过提问帮助用户发现问题和权衡:

  • 提供思考框架:要考虑哪些维度
  • 质疑设计:指出潜在风险和权衡
  • 用户请求帮助时:生成设计建议供用户选择
何时 AI 可以生成内容
场景AI 行为
用户正在思考/描述设计只提问和质疑,不给方案
用户明确请求帮助先追问确认理解 → 加载规范 → 生成建议 → 询问意见
用户卡住(多轮无进展)提供思考方向,仍以问题形式呈现
第 6 节业界调研AI 主动搜索并提供业界方案作为参考
AI 生成内容的前置条件
  1. AI 已完成代码调研(理解现有实现)
  2. 用户明确请求帮助
  3. AI 已充分追问(理解设计目标、约束、权衡)
  4. 加载相关规范(见 规范加载)

前置条件

  • spec.md 已存在且第 1-3 节(背景、目标、需求)完整
  • 如果不存在或不完整 → 停止,切换到 workflow-requirements-clarification Skill

触发条件

  • 用户说"开始设计"、"设计方案"
  • workflow-requirements-clarification 完成后用户确认进入设计阶段

规范加载(按需)

在讨论到相关 section 时才加载对应规范,不要在开始时一次性加载所有规范:

规范何时加载
bp-architecture-design Skill讨论 4.1 方案概览时加载
bp-component-design Skill讨论 4.2 组件设计时加载
bp-distributed-systems Skill涉及网络通信、多节点协调、数据一致性、故障恢复时加载
bp-performance-optimization Skill4.3 核心逻辑完成后加载,优化性能方面的设计考量
workflow-test-generation Skill讨论 7. 测试计划时加载

对话模式

AI 角色边界
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:条件分支**
- 优点:简单直接
- 缺点:会修改现有代码路径

你倾向于哪个方向?或者有其他想法?"

工作流程

Step 0: 代码调研 + 需求摘要(AI 自主完成)

目标:理解现有实现 + 确认对需求的理解

AI 操作:

  1. 读取 spec.md 的 1-3 章节
  2. 调用 codebase-researcher subagent 深度调研相关代码(模块结构、接口、依赖链、技术约束)
  3. 生成摘要向用户确认

向用户汇报(必须):

我已读完 spec.md 并调研了相关代码:

**需求理解**:
- 问题:[复述 spec.md 中的问题]
- 目标:[复述目标]
- 关键约束:[复述非功能需求]

**代码调研**:
- 相关模块:[列出发现的模块]
- 现有接口:[列出相关接口]
- 技术约束:[发现的约束]

请确认我的理解是否正确?有遗漏或错误的地方吗?

结束条件:用户确认理解正确。必须等用户确认后才能进入设计讨论。

Step 1: 开始设计讨论
好的,我们现在进入 **系统设计** 阶段,从 **4.1 方案概览** 开始。

请描述一下你的整体设计思路。
Step 2: 按 section 顺序讨论

每轮只讨论一个 section。详细的 section 引导模式参见 reference/section-guide.md。

判断 section 是否适用:

AI:"4.2.3 数据模型这个 section,你的需求涉及新的数据结构吗?不涉及可以跳过。"

用户跳过时,在 spec.md 标注 N/A - 本需求不适用。

Step 3: 更新 spec.md

每个 section 完成后:

  1. 复述用户设计内容,确认理解正确
  2. 将用户确认的内容写入 spec.md
  3. 更新 todo 状态
  4. 进入下一个 section

强制规则

  1. AI 自主调研代码:现有实现、接口等信息 AI 必须自己读代码获取
  2. 设计前先确认理解:展示需求摘要 + 代码调研结果,等用户确认
  3. 默认用户主导:AI 默认只提问和质疑
  4. 用户请求时可生成:用户明确请求帮助时,AI 可以生成设计建议
  5. 生成前必须追问:即使用户请求帮助,也要先追问确认约束和目标
  6. 每轮一个 section:按顺序逐个讨论
  7. 严格顺序约束:4.1 未完成前禁止讨论或写入 4.2/4.3,4.2 未完成前禁止讨论或写入 4.3(详见 section-guide)
  8. 内容粒度自检:写入 spec.md 前检查内容是否属于当前 section 的抽象层级,具体函数名/调用点清单属于 4.3,类/接口签名属于 4.2(详见 section-guide)
  9. 只记录确认内容:spec.md 内容必须是用户确认的

反模式

❌ 错误做法✅ 正确做法
问用户"现有实现是怎样的"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

Files

SKILL.md and 1 other file in skills/workflow-system-design of davidYichengWei/agentic-engineering-framework.

  • SKILL.md
  • reference/section-guide.md

Open the folder on GitHubat commit 1f7ac0f

Compare with similar skills

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.

Workflow System Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow System Design this skilldavidYichengWei/agentic-engineering-framework158—~1kAutomated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • 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.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    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.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    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.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    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.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from davidYichengWei/agentic-engineering-framework

All 14 skills in this repo
  • Architecture Design Principles

    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.

    158 GitHub stars~545 tokensUpdated 6 mo ago
    Auto-check passed
  • General Coding Best Practices

    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.

    158 GitHub stars~631 tokensUpdated 6 mo ago
    Auto-check passed
  • Component Design Principles

    davidYichengWei/agentic-engineering-framework

    Chinese-language checklists for component-level design: class and module structure, public interfaces, data models, concurrency and error handling.

    158 GitHub stars~1k tokensUpdated 6 mo ago
    Auto-check passed
  • Skill Authoring Guide (Chinese)

    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.

    158 GitHub stars~788 tokensUpdated 6 mo ago
    Auto-check passed
  • Self-Refinement from Corrections

    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.

    158 GitHub stars~575 tokensUpdated 6 mo ago
    Auto-check passed
  • Root-Cause Troubleshooting

    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.

    158 GitHub stars~646 tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Workflow System Design

What does Workflow System Design do?

系统设计。当 spec.md 前三章节(背景、目标、需求)已完整但设计章节为空时调用。按 spec.md 章节顺序逐个与用户讨论,每轮只处理一个 section。. Workflow System Design is an agent skill from davidYichengWei/agentic-engineering-framework.

When should I use Workflow System Design?

Workflow System Design fits situations like: development work in your project.

How do I install Workflow System Design in Claude Code?

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.

How do I install Workflow System Design in Codex?

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.

Can I use Workflow System 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 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.

What does Workflow System Design need to run?

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

Does Workflow System 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 Workflow System 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 Workflow System Design use?

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.

How many tokens does Workflow System Design use?

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.

What are the alternatives to Workflow System Design?

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.

Who maintains Workflow System Design?

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.