Agent skill

Dev Workflow

by xstongxue in xstongxue/best-skills

开发流程五步法。支持需求理解、方案设计、代码实现、代码审查、Bug 修复。当用户提到「需求分析」「方案设计」「代码实现」「代码审查」「理解需求」「技术设计」「开始写代码」「Review」「检查代码」「bug」「报错」「崩溃」「异常」「出错了」时使用。

Apache-2.0Auto-check passed

Install Dev Workflow

skills CLI
$ npx skills add xstongxue/best-skills --skill dev-workflow -a claude-code

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

GitHub CLI
$ gh skill install xstongxue/best-skills dev-workflow --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/xstongxue/best-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dev-workflow .claude/skills/dev-workflow && 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
dev-workflow
GitHub stars
3k
Token cost
~395 tokens
SKILL.md length
74 words
Files
24
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

开发流程五步法。支持需求理解、方案设计、代码实现、代码审查、Bug 修复。当用户提到「需求分析」「方案设计」「代码实现」「代码审查」「理解需求」「技术设计」「开始写代码」「Review」「检查代码」「bug」「报错」「崩溃」「异常」「出错了」时使用。

  • Works in 2 steps: :识别当前步骤 → :执行、输出与落盘
  • SKILL.md covers Step 1:识别当前步骤, Step 2:执行、输出与落盘 and 注意事项
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dev Workflow is an agent skill from xstongxue/best-skills. 开发流程五步法。支持需求理解、方案设计、代码实现、代码审查、Bug 修复。当用户提到「需求分析」「方案设计」「代码实现」「代码审查」「理解需求」「技术设计」「开始写代码」「Review」「检查代码」「bug」「报错」「崩溃」「异常」「出错了」时使用。

Its SKILL.md is about 400 tokens, which your agent loads only when the skill is triggered. The skill folder holds 26 other files (for example `reference/bug-fix.md`, `reference/design.md` and `reference/implementation.md`).

The licence is Apache-2.0.

Example prompts

  • “/dev-workflow”

Workflow steps

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

  1. :识别当前步骤
  2. :执行、输出与落盘

What it can do on your machine

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

Dev Workflow loads about 395 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 74 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~395

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 xstongxue/best-skills at commit 9aa4e55, republished under its Apache-2.0 licence (© xstongxue). 74 words, ~395 tokens.

Download SKILL.mdSave it as .claude/skills/dev-workflow/SKILL.md (or your agent's skills folder). This skill also uses 23 other files; get the full folder from GitHub.
name
dev-workflow
description
开发流程五步法。支持需求理解、方案设计、代码实现、代码审查、Bug 修复。当用户提到「需求分析」「方案设计」「代码实现」「代码审查」「理解需求」「技术设计」「开始写代码」「Review」「检查代码」「bug」「报错」「崩溃」「异常」「出错了」时使用。

开发流程五步法

需求理解 → 方案设计 → 代码实现 → 代码审查 → Bug 修复

Step 1:识别当前步骤

根据用户需求选择对应 reference 文件执行:

步骤文件触发关键词
需求理解requirement.md需求分析、理解需求、整理需求、帮我梳理
方案设计design.md方案设计、技术设计、架构设计、怎么实现
代码实现implementation.md代码实现、开始写代码、帮我实现、写一下
代码审查review.md代码审查、Review、检查代码、看看有没有问题
Bug 修复bug-fix.mdbug、报错、崩溃、异常、不工作、出错了、测试失败

Step 2:执行、输出与落盘

读取对应 reference 中的完整流程,按步骤执行,输出符合该阶段要求的交付物。

自动落盘(默认必须写入):

  • 需求理解:docs/<feature>/01-需求理解.md
  • 方案设计:docs/<feature>/02-方案设计.md

可选落盘(默认不写,仅当用户明确要求时才写入):

  • 代码审查:docs/<feature>/03-代码审查.md
  • Bug 修复:docs/<feature>/04-bug修复.md

落盘规则:

  • 目录为当前工作目录 docs/ 下,不存在则创建
  • 按功能划分子目录:能识别出功能(如登录、测试、部署等)就必须写入 docs/<feature>/,即使只有一个功能也不写入根目录;涉及多个功能时各建子目录,同一功能的全部文档归入同一子目录
  • 无法识别功能或跨功能全局性内容(如整体架构设计):写入 docs/通用/
  • <feature> 使用稳定标识(建议用功能英文名或代码目录名/包名,如 login、deploy,避免同义词混用)
  • 演进式更新(不追加):主文件永远是最新完整版,结构为 # 文档标题 → ## 修订记录(表格:版本 | 日期 | 摘要)→ 本次完整正文
  • 首次写入:创建文件,修订记录写入 v1 | YYYY-MM-DD HH:mm | 初版
  • 再次写入:先将旧文件整体移入 docs/<feature>/archive/<原文件名>-v<N>-<YYYYMMDD>.md(同日多次归档加时分后缀),再重写主文件,修订记录表新增一行(版本号递增,摘要为一句话变更概括)
  • 若用户明确指定了其他文件路径,优先按用户指定路径写入
  • 可选维护 docs/功能索引.md 记录功能名与文档路径映射

注意事项

  • 每步完成后提示用户进入下一阶段
  • 上游缺失时:提示用户先完成前置步骤,或简要收集关键信息后继续

© xstongxue, Apache-2.0. 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 23 other files in skills/dev-workflow of xstongxue/best-skills.

  • SKILL.md
  • reference/bug-fix.md
  • reference/design.md
  • reference/implementation.md
  • reference/requirement.md
  • reference/review-kit/guides/architecture-review-guide.md
  • reference/review-kit/guides/c.md
  • reference/review-kit/guides/common-bugs-checklist.md
  • reference/review-kit/guides/cpp.md
  • reference/review-kit/guides/css-less-sass.md
  • reference/review-kit/guides/go.md
  • reference/review-kit/guides/java.md
  • reference/review-kit/guides/performance-review-guide.md
  • reference/review-kit/guides/python.md
  • reference/review-kit/guides/qt.md
  • reference/review-kit/guides/react.md
  • reference/review-kit/guides/rust.md
  • reference/review-kit/guides/security-review-guide.md
  • … and 6 more

Open the folder on GitHubat commit 9aa4e55

Compare with similar skills

Dev Workflow 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.

Dev Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dev Workflow this skillxstongxue/best-skills3k—~395Automated safety check: PassApache-2.0
Bfe Rd Workflowbfenetworks/bfe6.3k—~1.3kAutomated safety check: PassApache-2.0
Marp Slides Creatorbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~4.2kAutomated safety check: NotesCustom licence
Skill Publish LogZJU-REAL/Easel3.2k—~976Automated safety check: PassApache-2.0
Skill Collab ProposalZJU-REAL/Easel3.2k—~728Automated safety check: PassApache-2.0
Huashu Image Uploadalchaincyf/huashu-skills1.7k—~989Automated safety check: PassMIT

Similar skills

  • Bfe Rd Workflow

    bfenetworks/bfe

    引导用户在 bfe 代码库中完成一次完整的功能研发流程,包括需求对齐、文档修改、代码实现、集成测试与回归验证. An agent skill from bfenetworks/bfe.

    6.3k GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Marp Slides Creator

    brycewang-stanford/Auto-Empirical-Research-Skills

    专业Marp演示文稿制作助手。支持完整工作流程:工作空间初始化、内容分析、slides制作、多维度审阅、中文语言规范审阅(中文演示文稿)、PNG转换检查、终稿确定。所有产出物集中管理在项目工作文件夹中。当用户提到"制作slides"、"做PPT"、"演示文稿"、"Marp"、"幻灯片"、"presentation"等关键词时自动启用。Professional Marp presentation…

    4.5k GitHub stars~4.2k tokensUpdated 3 days ago
    Documents & OfficeAuto-check: notes
  • Skill Publish Log

    ZJU-REAL/Easel

    发布记录管理。当用户提到"记一下刚发的"、"发布记录"、"这个月发了多少"、"发布历史"、 "记录一下"、"发布日志"、"上次发了什么"时触发。支持记录每次发布的内容信息(平台、标题、 链接、时间、初始数据),并提供查询和统计功能,方便后续复盘。

    3.2k GitHub stars~976 tokensUpdated yesterday
    Auto-check passed
  • Skill Collab Proposal

    ZJU-REAL/Easel

    品牌合作方案与联名策划。当用户提到"品牌合作"、"商单方案"、"合作报价"、"联名"、"联动方案"、 "博主合作"、"品牌植入"、"商务合作"、"合作提案"时触发。支持两种模式:商单方案(品牌找上门, 基于 KOL 定价表生成报价、内容形式、排期、KPI 预估)和联名策划(与博主/品牌联动,生成双方 优势互补、内容分工、互推策略)。

    3.2k GitHub stars~728 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Huashu Image Upload

    alchaincyf/huashu-skills

    文章配图一键生成并上传图床,自动插入Markdown链接。当用户提到"配图"、"插图"、"上传图片"、"文章配图"时使用。

    1.7k GitHub stars~989 tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed
  • Huashu Slides

    alchaincyf/huashu-skills

    从内容到成品PPTX的端到端演示文稿制作,含AI插画生成和18种设计风格。当用户提到"做PPT"、"做幻灯片"、"演示文稿"、"Keynote"、"slides"时使用。

    1.7k GitHub stars~7.2k tokensUpdated 16 days ago
    Documents & OfficeAuto-check: notes

More from xstongxue/best-skills

All 15 skills in this repo
  • Create Skill

    xstongxue/best-skills

    Guides users through creating effective Agent Skills for Cursor.

    3k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed
  • Office File Process

    xstongxue/best-skills

    处理 Office 文档的一站式 skill:Word(.doc/.docx/.dotx)、Excel(.xls/.xlsx/.xlsm/.csv)、PowerPoint(.ppt/.pptx/.potx) 的创建、读取、编辑、提取、转换、校验。触发:『读取 word 文档』『提取 excel 内容』『看 ppt 讲了什么』、.doc 老格式打不开、生成/编辑 Word…

    3k GitHub stars~1.8k tokensUpdated 25 days ago
    Auto-check passed
  • Pptgen Drawio

    xstongxue/best-skills

    根据论文或汇报内容生成多页 Draw.io 格式 PPT,支持论文答辩与通用汇报两种模式,自动导出为 .pptx。当用户提到论文答辩 PPT、答辩幻灯片、通用 PPT、汇报 PPT、根据模板生成 PPT、drawio2pptx 时使用。

    3k GitHub stars~2.1k tokensUpdated 25 days ago
    Auto-check passed
  • Wechat Article Writer

    xstongxue/best-skills

    公众号/自媒体全流程。根据用户表述自动匹配:撰写文章、封面图、正文插图、风格提取。支持多种写作风格。当用户提到写公众号、技术博客、公众号封面、正文插图、步骤图、演示图、流程示意、分析写作风格、克隆文风、模仿爆款、提取风格时使用。详见 reference 目录。

    3k GitHub stars~2k tokensUpdated 25 days ago
    Auto-check: notes
  • Drawio Diagram

    xstongxue/best-skills

    为深度学习模型、网络架构、算法流程等生成标准 Draw.io (.drawio) 格式的可视化图表;支持从零生成与风格迁移两种模式。从零生成:模型架构图、流程图、感受野示意图等;风格迁移:参考图 + 内容描述/项目 → 按参考图风格生成新图。确保 XML 格式正确,可直接在 Draw.io 中打开编辑。

    3k GitHub stars~487 tokensUpdated 25 days ago
    Auto-check passed
  • Project Docs

    xstongxue/best-skills

    对任意代码项目生成一套面向新人的循序渐进文档集,输出到 docs/ 目录。含架构、设计思想、语言特性、代码导读、运行时模型、构建、对接、调试、设计规范共 9 篇,支持全部生成 / 只写几篇 / 更新已有文档。当用户提到"生成项目文档"、"新人文档"、"上手文档"、"架构文档"、"代码导读"、"项目理解"、"深入理解项目"、"onboarding…

    3k GitHub stars~720 tokensUpdated 25 days ago
    Auto-check passed

Questions about Dev Workflow

What does Dev Workflow do?

开发流程五步法。支持需求理解、方案设计、代码实现、代码审查、Bug 修复。当用户提到「需求分析」「方案设计」「代码实现」「代码审查」「理解需求」「技术设计」「开始写代码」「Review」「检查代码」「bug」「报错」「崩溃」「异常」「出错了」时使用。. Dev Workflow is an agent skill from xstongxue/best-skills.

How do I install Dev Workflow in Claude Code?

Run `npx skills add xstongxue/best-skills --skill dev-workflow -a claude-code`. Or copy the skill folder (skills/dev-workflow in xstongxue/best-skills) into .claude/skills/dev-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Dev Workflow in Codex?

Run `npx skills add xstongxue/best-skills --skill dev-workflow -a codex`. Or copy the skill folder (skills/dev-workflow in xstongxue/best-skills) into .agents/skills/dev-workflow in your project. Codex loads it when a task matches its description.

Can I use Dev Workflow 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 xstongxue/best-skills --skill dev-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dev-workflow, .gemini/skills/dev-workflow, .github/skills/dev-workflow and .opencode/skills/dev-workflow in your project.

What does Dev Workflow need to run?

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

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

Dev Workflow is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dev Workflow use?

About 395 tokens (SKILL.md is roughly 1.6k 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 Dev Workflow?

Skills that share tags, products or a category with Dev Workflow: Bfe Rd Workflow (bfenetworks/bfe, 6.3k stars), Marp Slides Creator (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars), Skill Publish Log (ZJU-REAL/Easel, 3.2k stars) and Skill Collab Proposal (ZJU-REAL/Easel, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dev Workflow?

xstongxue (a GitHub user) maintains it in xstongxue/best-skills, which has 2,951 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 13, 2026.

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