claude-dev-skill

claude-dev-skill 是什么？

claude-dev-skill 是 Claude Code 的自定义技能，将 Claude 转变为使用多名 AI 工作者构建软件的“技术主管”流程。该技能提供结构化的多阶段工作流，在隔离的工作树中协调并行工作者工作，通过 PR 和审查路由变更，以减少上下文丢失和合并冲突。

其核心目的是超越单线程代码生成：指导需求对齐（PRD）、架构决策、任务分解、并行实现、静态 QA 检查，以及结构化的 PR 审查/合并步骤。

/dev 命令工作流（多阶段 SOP）：从请求分类开始，运行 PRD 对齐、架构与问题创建、工作者实现、QA 验证，以及 PR 合并协调。
技术主管路由规则：主对话作为协调者处理，“绝不直接编写代码”，变更需通过 Worker Agent → PR → 审查流程。
通过工作树实现并行 Worker Agents：生成多名工作者代理，在隔离的工作树中并行开发，支持功能的不同部分（例如，认证、API、前端）。
编码前冲突扫描：工作开始前，工作者代理扫描其他开放 Issue 中的文件重叠，早起捕获潜在冲突。
合并后 PR 协调：合并后，扫描开放 PR 并通知需要变基的分支。
审查前安全关卡：强制运行安全工具（例如，Python 的 bandit 加 pip-audit，或 Node 的 npm audit）作为审查前必备步骤。
带否决条件的结构化 PR 审查清单：代码审查通过 7 项清单完成，包含强制否决条件。
测试覆盖的反例自检：包含六类自检，确保工作者考虑 Null/Empty/边界/外部故障/并发/恶意输入场景。

安装技能文件 到 Claude Code 的命令目录（macOS/Linux/Windows 的脚本安装，或手动复制并保留目录结构）。
确保已登录 Claude Code (Anthropic 官方 CLI)。
使用带认证会话的 GitHub CLI (gh)（先运行 gh auth login）。
在 Claude Code 中运行 /dev [可选描述]。技能将分类请求（例如，新项目、新功能、bug 修复、hotfix、架构变更、重构）并进入相应流程。

典型运行遵循仓库中所示阶段：PRD 对齐（两轮）、架构与任务分解（GitHub Issues）、并行工作树中的工作者执行、QA 静态验证，以及清单驱动的 PR 审查与合并。

基于现有 PRD 构建中小型 Web 后端功能：使用 /dev 将现有产品需求文档转化为架构决策、GitHub Issues 和并行工作者实现。
同时实现多个模块并最小化合并冲突：让单独的工作者代理处理不同组件（例如，认证 vs. 任务 CRUD API vs. 前端组件），依赖编码前冲突扫描和合并后变基协调。
协调 bug 修复或 hotfix 工作：对于 bug 修复或紧急 hotfix，流程分类请求类型并路由至架构审查、工作变更、QA 验证和结构化 PR 合并。
带结构化审查的系统性重构：重构时，SOP 的反例自检和合并前安全关卡确保工作者考虑边缘情况并运行必要审计工具后再审查。
编码前需对齐的架构变更工作：使用第 1 阶段 PRD 对齐和第 2 阶段架构决策，确保团队计划在工作者开始实现前明确。

此技能工作流中的“tech lead”是什么意思？ 主对话充当协调者：对齐 PRD、决定架构方向、生成工作者代理，并强制代码变更通过 Worker Agent PR 和审查流程，而非直接在聊天中编辑。
claude-dev-skill 会从主对话直接编写代码吗？ 不会。工作流包含“铁律”：主对话绝不直接编写代码；变更需通过 Worker Agent 然后 PR 审查。
并行开发中的冲突如何处理？ 该技能包含编码前冲突扫描（工作者代理在启动前检查开放 Issues 的文件重叠）和合并后步骤（扫描开放 PR 以识别需 rebase 的分支）。
强制执行哪些安全检查？ 在审查阶段前，强制运行安全工具，如针对 Python 的 bandit 加 pip-audit，或针对 Node 的 npm audit，依仓库的 Security gate 描述。
此技能适用于生产部署工作吗？ 仓库范围说明其不适合需要生产部署的项目，因为不提供 DevOps/部署能力。

单代理代码助手（自动补全/聊天式）：这些专注于从提示直接编写代码，但通常不提供多代理、从 PRD 到 PR 的工作流及强制审查关卡。
传统多步提示 + 手动 PR 工作流：您可自行提示 Claude 分解任务并手动运行工作者，但会丢失内置 SOP 结构（分类、冲突扫描、QA 和检查清单审查协调）。
标准 GitHub 驱动团队工作流（无 AI SOP 的 Issues/PRs）：团队可使用 GitHub Issues 和 PR 审查复制部分流程，但“工作者代理”并行化和自动化阶段路由无法以相同方式提供。
其他专注于规划或测试的 Claude Code 自定义技能：而非端到端协调并行工作者代理，有些技能仅针对工作流某一部分（例如测试生成），集成和合并协调留给用户。