# AI 工作流 / AI Workflow

> This file is generated from the skill tree. Update source skills and rerun `python3 scripts/generate_category_readmes.py`.

聚焦 AI 编程 Agent 的规格、计划、实现、测试、审查、发布与持续同步工作流。

当前分类共 **43** 个技能。

## 推荐先看

- [skill-creator](./skill-creator/) - Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill''s description for better triggering accuracy.
- [idea-refine](./idea-refine/) - Refines ideas iteratively. Refine ideas through structured divergent and convergent thinking. Use \"idea-refine\" or \"ideate\" to trigger.
- [api-and-interface-design](./api-and-interface-design/) - Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.
- [browser-testing-with-devtools](./browser-testing-with-devtools/) - Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data via Chrome DevTools MCP.

## 技能总览

| 技能 | 简介 | 目录 | 详情 |
|------|------|------|------|
| `agent-workflow-designer` | Design production-grade multi-agent orchestration systems. Covers five core patterns (sequential pipeline, parallel fan-out/fan-in, hierarchical delegation, event-driven, consensus), platform-specific implementations, handoff protocols, state management, error recovery, context window budgeting, and cost optimization. | [目录](./agent-workflow-designer/) | [SKILL.md](./agent-workflow-designer/SKILL.md) |
| `api-and-interface-design` | Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend. | [目录](./api-and-interface-design/) | [SKILL.md](./api-and-interface-design/SKILL.md) |
| `brainstorming` | You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation. | [目录](./brainstorming/) | [SKILL.md](./brainstorming/SKILL.md) |
| `browser-testing-with-devtools` | Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data via Chrome DevTools MCP. | [目录](./browser-testing-with-devtools/) | [SKILL.md](./browser-testing-with-devtools/SKILL.md) |
| `ci-cd-and-automation` | Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies. | [目录](./ci-cd-and-automation/) | [SKILL.md](./ci-cd-and-automation/SKILL.md) |
| `code-review-and-quality` | Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. | [目录](./code-review-and-quality/) | [SKILL.md](./code-review-and-quality/SKILL.md) |
| `code-simplification` | Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity. | [目录](./code-simplification/) | [SKILL.md](./code-simplification/SKILL.md) |
| `context-engineering` | Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project. | [目录](./context-engineering/) | [SKILL.md](./context-engineering/SKILL.md) |
| `debugging-and-error-recovery` | Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn''t match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing. | [目录](./debugging-and-error-recovery/) | [SKILL.md](./debugging-and-error-recovery/SKILL.md) |
| `deep-research` | Generate format-controlled research reports with evidence tracking, citations, and iterative review. This skill should be used when users request a research report, literature review, market or industry analysis, competitive landscape, policy or technical brief, or require a strict report template and section formatting that a single deepresearch pass cannot reliably enforce. | [目录](./deep-research/) | [SKILL.md](./deep-research/SKILL.md) |
| `deprecation-and-migration` | Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. | [目录](./deprecation-and-migration/) | [SKILL.md](./deprecation-and-migration/SKILL.md) |
| `dispatching-parallel-agents` | Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | [目录](./dispatching-parallel-agents/) | [SKILL.md](./dispatching-parallel-agents/SKILL.md) |
| `documentation-and-adrs` | Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase. | [目录](./documentation-and-adrs/) | [SKILL.md](./documentation-and-adrs/SKILL.md) |
| `executing-plans` | Use when you have a written implementation plan to execute in a separate session with review checkpoints | [目录](./executing-plans/) | [SKILL.md](./executing-plans/SKILL.md) |
| `find-skills` | 让 Agent 自动搜索并安装合适技能，解决不知道该用哪个技能的问题。 | [目录](./find-skills/) | [SKILL.md](./find-skills/SKILL.md) |
| `finishing-a-development-branch` | Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup | [目录](./finishing-a-development-branch/) | [SKILL.md](./finishing-a-development-branch/SKILL.md) |
| `frontend-ui-engineering` | Builds production-quality UIs. Use when building or modifying user-facing interfaces. Use when creating components, implementing layouts, managing state, or when the output needs to look and feel production-quality rather than AI-generated. | [目录](./frontend-ui-engineering/) | [SKILL.md](./frontend-ui-engineering/SKILL.md) |
| `git-workflow-and-versioning` | Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams. | [目录](./git-workflow-and-versioning/) | [SKILL.md](./git-workflow-and-versioning/SKILL.md) |
| `idea-refine` | Refines ideas iteratively. Refine ideas through structured divergent and convergent thinking. Use \"idea-refine\" or \"ideate\" to trigger. | [目录](./idea-refine/) | [SKILL.md](./idea-refine/SKILL.md) |
| `incremental-implementation` | Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you''re about to write a large amount of code at once, or when a task feels too big to land in one step. | [目录](./incremental-implementation/) | [SKILL.md](./incremental-implementation/SKILL.md) |
| `nexus` | Meta-orchestrator that coordinates specialist AI agent teams. Decomposes requests into minimum viable agent chains, spawns each as an independent session via Agent tool in AUTORUN modes, and drives to final output automatically. | [目录](./nexus/) | [SKILL.md](./nexus/SKILL.md) |
| `performance-optimization` | Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing. | [目录](./performance-optimization/) | [SKILL.md](./performance-optimization/SKILL.md) |
| `planning-and-task-breakdown` | Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | [目录](./planning-and-task-breakdown/) | [SKILL.md](./planning-and-task-breakdown/SKILL.md) |
| `prompt-optimizer` | Transform vague prompts into precise, well-structured specifications using EARS (Easy Approach to Requirements Syntax) methodology. This skill should be used when users provide loose requirements, ambiguous feature descriptions, or need to enhance prompts for AI-generated code, products, or documents. Triggers include requests to "optimize my prompt", "improve this requirement", "make this more specific", or when raw requirements lack detail and structure. | [目录](./prompt-optimizer/) | [SKILL.md](./prompt-optimizer/SKILL.md) |
| `rally` | Multi-session parallel orchestrator using Claude Code Agent Teams API and Codex CLI Subagents to launch, manage, and coordinate concurrent task execution across multiple instances. Use when parallel work is needed. | [目录](./rally/) | [SKILL.md](./rally/SKILL.md) |
| `receiving-code-review` | Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | [目录](./receiving-code-review/) | [SKILL.md](./receiving-code-review/SKILL.md) |
| `requesting-code-review` | Use when completing tasks, implementing major features, or before merging to verify work meets requirements | [目录](./requesting-code-review/) | [SKILL.md](./requesting-code-review/SKILL.md) |
| `security-and-hardening` | Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. | [目录](./security-and-hardening/) | [SKILL.md](./security-and-hardening/SKILL.md) |
| `sherpa` | Workflow guide that decomposes complex tasks (Epics) into Atomic Steps under 15 minutes each. Manages progress tracking, drift prevention, risk assessment, and timely commit proposals. Use when complex task decomposition is needed. | [目录](./sherpa/) | [SKILL.md](./sherpa/SKILL.md) |
| `shipping-and-launch` | Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | [目录](./shipping-and-launch/) | [SKILL.md](./shipping-and-launch/SKILL.md) |
| `skill-creator` | Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill''s description for better triggering accuracy. | [目录](./skill-creator/) | [SKILL.md](./skill-creator/SKILL.md) |
| `skill-reviewer` | Reviews and improves Claude Code skills against official best practices. Supports three modes - self-review (validate your own skills), external review (evaluate others'' skills), and auto-PR (fork, improve, submit). Use when checking skill quality, reviewing skill repositories, or contributing improvements to open-source skills. | [目录](./skill-reviewer/) | [SKILL.md](./skill-reviewer/SKILL.md) |
| `skills-search` | This skill should be used when users want to search, discover, install, or manage Claude Code skills from the CCPM registry. Triggers include requests like "find skills for PDF", "search for code review skills", "install cloudflare-troubleshooting", "list my installed skills", "what does skill-creator do", or any mention of finding/installing/managing Claude Code skills or plugins. | [目录](./skills-search/) | [SKILL.md](./skills-search/SKILL.md) |
| `source-driven-development` | Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters. | [目录](./source-driven-development/) | [SKILL.md](./source-driven-development/SKILL.md) |
| `spec-driven-development` | Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. | [目录](./spec-driven-development/) | [SKILL.md](./spec-driven-development/SKILL.md) |
| `subagent-driven-development` | Use when executing implementation plans with independent tasks in the current session | [目录](./subagent-driven-development/) | [SKILL.md](./subagent-driven-development/SKILL.md) |
| `test-driven-development` | Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you''re about to modify existing functionality. | [目录](./test-driven-development/) | [SKILL.md](./test-driven-development/SKILL.md) |
| `using-agent-skills` | Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked. | [目录](./using-agent-skills/) | [SKILL.md](./using-agent-skills/SKILL.md) |
| `using-git-worktrees` | Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | [目录](./using-git-worktrees/) | [SKILL.md](./using-git-worktrees/SKILL.md) |
| `using-superpowers` | Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions | [目录](./using-superpowers/) | [SKILL.md](./using-superpowers/SKILL.md) |
| `verification-before-completion` | Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | [目录](./verification-before-completion/) | [SKILL.md](./verification-before-completion/SKILL.md) |
| `writing-plans` | Use when you have a spec or requirements for a multi-step task, before touching code | [目录](./writing-plans/) | [SKILL.md](./writing-plans/SKILL.md) |
| `writing-skills` | Use when creating new skills, editing existing skills, or verifying skills work before deployment | [目录](./writing-skills/) | [SKILL.md](./writing-skills/SKILL.md) |

## 维护方式

- 新增技能时保持 `skills/<category>/<skill-name>/SKILL.md` 结构。
- 若技能有 `scripts/`、`references/`、`assets/`，优先复用并保持说明同步。
- 修改分类内容后可重新运行：`python3 scripts/generate_category_readmes.py`
