Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:51:52 +08:00
commit 7886816c48
15 changed files with 1327 additions and 0 deletions

55
commands/create.md Normal file
View File

@@ -0,0 +1,55 @@
---
description: Create a complete product feature specification using the spec-driven workflow
---
You are initiating the spec-driven development workflow to create a complete product feature specification.
## Your Task
Use the **spec-orchestrator** agent to create a comprehensive specification for the feature described by the user.
## Instructions
1. **Understand the feature request**: Analyze what the user wants to build
2. **Invoke the orchestrator**: Use the Task tool to launch the spec-orchestrator agent with the following prompt:
```
Create a complete specification for the following feature: {user's feature description}
Follow the complete spec-driven workflow:
1. Create requirements.md with clear user stories and acceptance criteria
2. Validate requirements using spec-requirements-validator
3. Create design.md with architecture, components, and code reuse analysis
4. Validate design using spec-design-validator
5. Create tasks.md with detailed implementation tasks
6. Validate tasks using spec-tasks-validator
7. Iterate on validation feedback until all documents pass
8. Provide completion summary with document paths
Feature context provided by user: {include any additional context the user mentioned}
```
3. **Present results**: Once the orchestrator completes, show the user:
- Paths to created documents
- Brief summary of what was created
- Validation status
- Next steps (review or begin implementation)
## Example Usage
User: "use spec workflow to create our user authentication feature"
Your response:
```
I'll create a complete specification for the user authentication feature using the spec-driven workflow.
[Invoke spec-orchestrator agent with appropriate prompt]
[Present results when orchestrator completes]
```
## Notes
- The orchestrator will handle all document creation and validation
- You just need to invoke it with the right context and present results
- The user may also invoke this with `/spec-create {feature-name}`

77
commands/validate.md Normal file
View File

@@ -0,0 +1,77 @@
---
description: Validate existing requirements, design, or tasks document
---
You are validating an existing specification document.
## Your Task
Use the appropriate validator agent to validate the specified document type.
## Instructions
1. **Identify document type**: Determine if validating requirements, design, or tasks
2. **Identify document path**: Get the path to the document to validate
3. **Invoke appropriate validator**:
### For Requirements Validation
Use the **spec-requirements-validator** agent:
```
Validate the requirements document at: {path}
Load the requirements template and product context (if available), then provide comprehensive validation feedback on:
- Template structure compliance
- Product vision alignment
- User stories quality
- Acceptance criteria completeness
- Non-functional requirements
- Clarity and testability
Provide rating (PASS/NEEDS_IMPROVEMENT/MAJOR_ISSUES) and specific feedback.
```
### For Design Validation
Use the **spec-design-validator** agent:
```
Validate the design document at: {path}
Load the design template and requirements document, then provide comprehensive validation feedback on:
- Template structure compliance
- Requirements coverage
- Architecture quality
- Technical standards compliance
- Code reuse and integration
- Documentation completeness
Provide rating (PASS/NEEDS_IMPROVEMENT/MAJOR_ISSUES) and specific feedback.
```
### For Tasks Validation
Use the **spec-tasks-validator** agent:
```
Validate the tasks document at: {path}
Load the tasks template, requirements, and design documents, then provide comprehensive validation feedback on:
- Template structure compliance
- Requirements coverage
- Design alignment
- Code reuse validation
- Task sequencing
- Implementation prompts quality
- Actionability and testing coverage
Provide rating (PASS/NEEDS_IMPROVEMENT/MAJOR_ISSUES) and specific feedback.
```
4. **Present validation results**: Show the user the validator's feedback
## Example Usage
User: "/spec-validate .claude/specs/auth/requirements.md"
User: "validate the design document for the auth feature"
## Notes
- Validators are read-only - they provide feedback but don't modify files
- Use validation feedback to iterate and improve documents
- All documents should achieve PASS rating before implementation