shinpr/claude-code-workflows

Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.

Claude Code Development Workflows

是什么 – 一组 Claude Code 插件，将 Claude Code AI 助手转变为结构化的开发流程引擎。这些插件编码了一套“配方”（例如 /recipe‑implement、/recipe‑design、/recipe‑review），引导模型完成以下步骤：

范围共识 – 用户与 Claude 就期望结果及排除项达成一致。
设计与规划 – Claude 生成设计文档、UI 规格、ADR 和工作计划，在编写任何代码前进行审查。
任务级实现 – 每个工作计划项被执行，根据仓库特定的质量规则进行验证，并自动提交。
独立审查 – 第二阶段的安全/审查代理在工作流结束前检查整个变更是否存在功能、可靠性或安全回归问题。

该系统有意分为三个插件家族：

插件	目标	典型入口点
`dev‑workflows`	后端或通用代码库	`/recipe‑implement`、`/recipe‑design`、…
`dev‑workflows‑frontend`	React/TypeScript 前端	`/recipe‑front‑design`、`/recipe‑front‑build`、…
`dev‑workflows‑fullstack`	同时包含前后端的项目	`/recipe‑fullstack‑implement`、…

为何可能使用它

你需要在设计讨论和实际代码生成之间建立正式交接，以确保 Claude 不会偏离已达成的产品目标。
你的团队希望拥有可重复的安全门（设计审查、工作计划审批、独立安全审查），由插件自动强制执行。
你已使用 Claude Code，并希望在多个仓库中保持相同的 AI 驱动工作流，无需每次重新发明流程。

快速开始（来自 README）

# 1. 启动 Claude Code
claude

# 2. 添加托管插件的市场
/plugin marketplace add shinpr/claude-code-workflows

# 3. 安装与项目类型匹配的插件
#   – 后端 / 通用
/plugin install dev-workflows@claude-code-workflows
/recipe-implement "为公共 API 添加速率限制"

#   – React 前端
/plugin install dev-workflows-frontend@claude-code-workflows
/recipe-front-design "添加账户恢复界面"

#   – 全栈
/plugin install dev-workflows-fullstack@claude-code-workflows
/recipe-fullstack-implement "使用 JWT + 登录表单添加用户认证"

每个仓库应只安装一个工作流插件；全栈插件已包含后端和前端配方。

工作流如何工作（高层次流程）

请求 → 确认结果与排除项 →
   ┌─► 简单路径？ ──► 直接任务循环 → 完成
   │
   └─► 复杂？ → 检查 → 设计 → 审查 → 批准范围 →
        每个任务：实现 → 验证 → 质量检查 → 提交 →
        独立安全审查 → （修正循环） → 完成

选择哪条路径取决于产品决策的复杂性，而非文件数量。

插件引入的核心概念

工作计划 – 将每个已批准的需求（来自设计文档、ADR、UI 规格等）映射到一个或多个具体任务的表格。未覆盖的缺口会被标记，确保无遗漏。
任务模板 – 每个生成的任务都携带精确的验收标准和一个在提交前运行的“是/否”合规检查。
质量配置文件 – 存储在 docs/project‑context/quality.yaml 中的仓库特定的 lint、测试和安全规则。插件在每次验证步骤中读取此配置文件。
专用代理 – 插件协调一系列 AI 代理（如 requirement‑analyzer、code‑verifier、security‑reviewer），确保设计、实现和审查的关注点分离。

示例运行（来自 README 摘要）

用户运行 /recipe‑implement "为公共 API 添加速率限制"。
Claude 分析仓库，提出设计文档，用户批准。
生成工作计划，分为 4 个任务（添加中间件、更新配置、编写测试、更新文档）。
对每个任务，任务执行器 代理编写代码，代码验证器 运行仓库的质量配置文件，变更被提交。
所有任务完成后，安全审查器 代理进行独立检查；未发现问题，工作流结束。

何时不需要

如果变更只是一个快速的临时原型，或结果和安全实现边界已非常明确，你可以直接使用 Claude Code，无需额外工作流开销。

许可与贡献

许可证：MIT（参见 README 中的徽章）。
贡献：欢迎 PR；仓库包含 PRs welcome 徽章。

总结

shinpr/claude-code-workflows 不是你要导入到自己代码中的库；它是一个Claude Code 插件套件，为使用 Claude Code 的任何项目添加有纪律的、AI 驱动的开发流水线。通过编码设计审查、工作计划审批、任务级验证和独立安全审查，它帮助团队确保 Claude 生成的代码与已达成的产品目标和仓库质量标准保持一致。