AgentSkillsCN

sparc-methodology

SPARC 开发工作流:规格说明、伪代码、架构设计、细化优化、最终完成。这是一种结构化的开发方法,能够在编码前做好充分规划,确保复杂实现的顺利推进。适用场景:新功能开发、复杂实现、架构变更、系统重设计、集成工作、需求尚不清晰时使用。若只是简单的 Bug 修复、文档更新、配置修改、任务明确且规模较小,或日常维护工作,则可跳过此步骤。

SKILL.md
--- frontmatter
name: sparc-methodology
description: >
  SPARC development workflow: Specification, Pseudocode, Architecture, Refinement, Completion. A structured approach for complex implementations that ensures thorough planning before coding.
  Use when: new feature implementation, complex implementations, architectural changes, system redesign, integration work, unclear requirements.
  Skip when: simple bug fixes, documentation updates, configuration changes, well-defined small tasks, routine maintenance.

Sparc Methodology Skill

Purpose

SPARC development workflow: Specification, Pseudocode, Architecture, Refinement, Completion. A structured approach for complex implementations that ensures thorough planning before coding.

When to Trigger

  • new feature implementation
  • complex implementations
  • architectural changes
  • system redesign
  • integration work
  • unclear requirements

When to Skip

  • simple bug fixes
  • documentation updates
  • configuration changes
  • well-defined small tasks
  • routine maintenance

Commands

Specification Phase

Define requirements, acceptance criteria, and constraints

bash
npx @claude-flow/cli hooks route --task "specification: [requirements]"

Example:

bash
npx @claude-flow/cli hooks route --task "specification: user authentication with OAuth2, MFA, and session management"

Pseudocode Phase

Write high-level pseudocode for the implementation

bash
npx @claude-flow/cli hooks route --task "pseudocode: [feature]"

Example:

bash
npx @claude-flow/cli hooks route --task "pseudocode: OAuth2 login flow with token refresh"

Architecture Phase

Design system structure, interfaces, and dependencies

bash
npx @claude-flow/cli hooks route --task "architecture: [design]"

Example:

bash
npx @claude-flow/cli hooks route --task "architecture: auth module with service layer, repository, and API endpoints"

Refinement Phase

Iterate on the design based on feedback

bash
npx @claude-flow/cli hooks route --task "refinement: [feedback]"

Example:

bash
npx @claude-flow/cli hooks route --task "refinement: add rate limiting and brute force protection"

Completion Phase

Finalize implementation with tests and documentation

bash
npx @claude-flow/cli hooks route --task "completion: [final checks]"

Example:

bash
npx @claude-flow/cli hooks route --task "completion: verify all tests pass, update API docs, security review"

SPARC Coordinator

Spawn SPARC coordinator agent

bash
npx @claude-flow/cli agent spawn --type sparc-coord --name sparc-lead

Scripts

ScriptPathDescription
sparc-init.agents/scripts/sparc-init.shInitialize SPARC workflow for a new feature
sparc-review.agents/scripts/sparc-review.shRun SPARC phase review checklist

References

DocumentPathDescription
SPARC Overviewdocs/sparc.mdComplete SPARC methodology guide
Phase Templatesdocs/sparc-templates.mdTemplates for each SPARC phase

Best Practices

  1. Check memory for existing patterns before starting
  2. Use hierarchical topology for coordination
  3. Store successful patterns after completion
  4. Document any new learnings