mcpField
D
default-workflow

default-workflow

github.com/rysweet开发76132 次安装21 周前更新
代码仓库

关于 default-workflow

面向 amplihack 非简单代码变更的工作流技能，覆盖需求澄清、实现、测试、审查和合并。它引用统一的规范流程，并将各步骤交给专门的 Agent 执行。

主要功能

  1. 01结构化开发工作流
  2. 02需求与代码库分析
  3. 03专门 Agent 委派
  4. 04使用 TodoWrite 跟踪进度
  5. 05检查点与恢复指导

适用场景

  1. 01协调跨多个文件的功能实现
  2. 02管理复杂集成或重构
  3. 03工作流步骤失败后恢复开发

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rysweet/amplihack --skill default-workflow

安装后在 Claude Code 中输入/default-workflow确认已加载。

详细介绍

默认工作流技能

工作流图

flowchart TD
    subgraph P1["Phase 1: Requirements Clarification"]
        S0[Step 0: Workflow Preparation] --> S1[Step 1: Prepare Workspace]
        S1 --> S2[Step 2: Clarify Requirements]
        S2 --> S2b[Step 2b: Analyze Codebase]
        S2b --> S2c{Ambiguity?}
        S2c -->|yes| S2d[Step 2c: Resolve Ambiguity]
        S2c -->|no| S3
        S2d --> S3[Step 3: Create GitHub Issue]
        S3 --> S3b[Step 3b: Extract Issue Number]
    end

    subgraph P2["Phase 2: Design"]
        S4[Step 4: Setup Worktree/Branch] --> S5[Step 5: Architecture Design]
        S5 --> S5b{API needed?}
        S5b -->|yes| S5c[Step 5b: API Design]
        S5b -->|no| S5d
        S5c --> S5d{Database needed?}
        S5d -->|yes| S5e[Step 5c: Database Design]
        S5d -->|no| S5f
        S5e --> S5f[Step 5d: Security Review]
        S5f --> S5g[Step 5e: Design Consolidation]
    end

    subgraph P3["Phase 3: Implementation"]
        S6[Step 6: Documentation] --> S6b[Step 6b: Doc Review]
        S6b --> S6c[Step 6c: Doc Refinement]
        S6c --> S7[Step 7: Write Tests - TDD]
        S7 --> S8[Step 8: Implement]
        S8 --> S8b[Step 8b: Integration]
        S8b --> S9[Step 9: Refactor]
        S9 --> S9b[Step 9b: Optimize]
    end

    subgraph P4["Phase 4: Testing & Review"]
        S10[Step 10: Pre-commit Review] --> S10b[Step 10b: Security Review]
        S10b --> S10c[Step 10c: Philosophy Check]
        S10c --> S11[Step 11: Incorporate Feedback]
        S11 --> S11b[Step 11b: Implement Feedback]
        S11b --> S12[Step 12: Run Pre-commit Hooks]
        S12 --> S13[Step 13: Local Testing]
    end

    subgraph P5["Phase 5: Version & PR"]
        S14[Step 14: Bump Version - MANDATORY] --> S15[Step 15: Commit & Push]
        S15 --> S16[Step 16: Create Draft PR]
        S16 --> S16b[Step 16b: Outside-In Fix Loop]
    end

    subgraph P6["Phase 6: PR Review - MANDATORY"]
        S17a[Step 17a: Compliance Verification] --> S17b[Step 17b: Reviewer Agent]
        S17b --> S17c[Step 17c: Security Review]
        S17c --> S17d[Step 17d: Philosophy Guardian]
        S17d --> S17e{Blocking issues?}
        S17e -->|yes| S17f[Step 17e: Address Blocking]
        S17e -->|no| S17g
        S17f --> S17g[Step 17f: Verification Gate]
        S17g --> S18a[Step 18a: Analyze Feedback]
        S18a --> S18b[Step 18b: Implement Feedback]
        S18b --> S18c[Step 18c: Push Changes]
        S18c --> S18d[Step 18d: Respond to Comments]
        S18d --> S18e[Step 18e: Verification Gate]
    end

    subgraph P7["Phase 7: Merge"]
        S19a[Step 19a: Philosophy Check] --> S19b[Step 19b: Patterns Check]
        S19b --> S19c[Step 19c: Zero-BS Verification]
        S19c --> S19d[Step 19d: Verification Gate]
        S19d --> S20[Step 20: Final Cleanup]
        S20 --> S20b[Step 20b: Push Cleanup]
        S20b --> S20c[Step 20c: Quality Audit]
        S20c --> S21[Step 21: PR Ready]
        S21 --> S22[Step 22: Ensure Mergeable]
        S22 --> S22b[Step 22b: Final Status]
    end

    P1 --> P2 --> P3 --> P4 --> P5 --> P6 --> P7

目的

此技能为 amplihack 中所有非简单代码变更提供标准开发工作流。检测到涉及多个文件的实现、复杂集成或重大重构时，此技能会自动激活。

工作流定义了标准执行流程：从需求澄清，到设计、实现、测试、审查和合并。它会在每个步骤中协调专用 Agent，并始终确保遵循规范，从而保证质量一致。

这是一个轻量封装，用于引用存储在单一规范位置的完整工作流定义，确保技能接口与工作流规范之间没有重复或偏差。

规范源

此技能是对规范工作流的轻量封装：

来源：~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md（471+ 行）

规范工作流包含完整的开发流程、所有详细信息、Agent 规范和执行指南。

执行说明

激活此技能后，你必须：

  1. 立即阅读规范工作流：

    Read(file_path="~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md")

    注意：路径相对于项目根目录。Claude Code 会自动解析此路径。

  2. 严格按照规范工作流中指定的所有步骤执行

  3. 使用 TodoWrite 按以下格式跟踪工作流步骤的进度：

    • Step N: [Step Name] - [Specific Action]
    • 示例：Step 1: Rewrite and Clarify Requirements - Use prompt-writer agent
    • 这有助于用户准确了解当前执行的是哪个工作流步骤

  4. 按照每个工作流步骤的指定调用专用 Agent：

    • 步骤 1：prompt-writer、analyzer、ambiguity Agent
    • 步骤 4：architect、api-designer、database、tester、security Agent
    • 步骤 5：builder、integration Agent
    • 步骤 6：cleanup、optimizer Agent
    • 步骤 7：pre-commit-diagnostic Agent
    • 步骤 9-15：审查与合并 Agent

为何采用这种模式

优点：

  • 工作流定义的唯一事实来源
  • 不存在内容重复或偏差
  • 工作流变更只需在规范位置进行一次
  • 明确技能与工作流之间的委派约定
  • 减少 Token 使用量（技能约 60 行，规范源超过 471 行）

自动激活触发条件

满足以下情况时，此技能会自动激活：

  • 功能涉及多个文件（5 个以上）
  • 跨组件的复杂集成
  • 影响 5 个以上文件的重构
  • 任何需要结构化工作流的非简单代码变更

已知故障点与恢复指南

工作流执行期间常见的失败步骤。执行此工作流的 Agent 遇到这些步骤时，必须应用文档所述的恢复模式。

步骤 3 — 创建问题（缺少标签）

故障：无法创建标签时（权限被拒、API 超时），gh label create 会静默失败。 恢复措施：添加标签为尽力而为。如果 gh issue create --label 失败，则不带 --label 重试。问题本身才是关键产物，而不是其标签。

步骤 4 — 设置 Worktree（无远程仓库 / 无 origin/main）

故障：仓库没有远程仓库或不存在 origin/main 时，git fetch origin main 会中止。 恢复措施：首先运行拓扑检测。如果不存在远程仓库，则使用 HEAD 作为基础引用，并跳过推送/上游设置。Worktree 输出中的 bootstrap 标志表示后续步骤应跳过远程操作。

步骤 4 — 初始推送（网络临时故障）

故障：新建分支时，git push origin <branch> 可能因网络问题而失败。 恢复措施：步骤 4 中的推送失败会发出明确的警告，并推迟到步骤 15/16 处理。提交并推送时会进行有限次数的重试（最多 3 次，每次间隔 2 秒）。创建 PR 前，步骤 16 也会重试推送。

步骤 5b — Agent 输出文件缺失

故障：Agent 输出文件未写入或已损坏，导致下游步骤因输入为空而失败。 弹性处理：如果 Agent 步骤生成的输出为空，配方运行器应明确显示错误。设计完成后（步骤 5e）和实现完成后（步骤 8b）创建的检查点会保留部分成果，以便工作流从最近的安全节点恢复。

步骤 15 — 推送到远程服务（上游跟踪）

故障：未设置上游分支（首次推送场景）时，git rev-list --count @{u}..HEAD 会失败。 弹性处理：明确检测上游分支是否缺失。如果 @{u} 执行失败，则无条件推送，而不是静默跳过。遇到暂时性网络错误时，采用退避策略重试推送。

步骤 16 — 创建 PR（已存在／没有提交）

故障：gh pr create 因“main 和分支之间没有提交”或 PR 重复而失败。 弹性处理：幂等性保护会在创建前按分支名称检查是否已有 PR。如果 PR 已存在，则重复使用。如果没有领先的提交，则明确显示错误，而不是创建空 PR。

步骤 21 — PR 就绪（大型模板变量）

故障：当 philosophy_check、patterns_check 或 quality_audit_results 模板变量包含 shell 元字符或超过 ARG_MAX 时，Shell && 链会中断。 弹性处理：大型模板变量通过 heredoc 捕获，并在用于 shell 命令前截断至 1KB。步骤 21 避免在 bash 中回显原始模板内容；Agent 步骤可原生处理大型文本。

检查点策略

工作流会在以下位置自动创建检查点，以防止工作成果丢失：

检查点步骤之后保留内容
checkpoint-after-design5e（设计整合）架构决策、API 设计、DB 架构
checkpoint-after-implementation8b（集成）测试、实现代码、集成工作
checkpoint-after-review-feedback11b（实现反馈）根据评审意见完成的更改

如果检查点之后的某个步骤失败，工作树分支会保留所有已提交的工作。Agent 可以使用现有工作树重新运行工作流，从最新的检查点恢复。

相关文件

  • 规范工作流：~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md
  • 命令接口：~/.amplihack/.claude/commands/amplihack/ultrathink.md
  • 编排器技能：~/.amplihack/.claude/skills/ultrathink-orchestrator/
  • 调查工作流：~/.amplihack/.claude/skills/investigation-workflow/

评论

支持 Markdown