majiayu000 name: tech-spec description: Tech spec knowledge base. Full workflow from requirement analysis, code research to spec output. Triggers: tech spec, feature design, requirement analysis. allowed-tools: Read, Grep, Glob, Write, Bash(git:*)
Tech Spec Skill
Trigger
- Keywords: tech spec, technical specification, spec review, review spec, requirement analysis, feature design
When NOT to Use
- Creating request documents (use /create-request)
- Code implementation (use feature-dev)
- Architecture consulting (use /codex-architect)
Commands
| Command | Purpose | When |
|---|---|---|
/tech-spec |
Produce tech spec | Starting from scratch |
/deep-analyze |
Deepen spec + roadmap | After initial concept |
/review-spec |
Review tech spec | Spec confirmation |
Workflow
sequenceDiagram
participant A as Analyst
participant C as Codebase
participant D as Document
A->>A: 1. Requirement clarification
A->>C: 2. Code research
C-->>A: Related modules
A->>A: 3. Solution design
A->>A: 4. Risk assessment
A->>A: 5. Work breakdown
A->>D: 6. Output document
Spec Structure
- Requirement summary (problem + goals + scope)
- Existing code analysis
- Technical solution (architecture + data model + API + core logic)
- Risks and dependencies
- Work breakdown
- Testing strategy
- Open questions
Verification
- Solution covers all requirement points
- Architecture diagrams use Mermaid
- Risks have mitigation strategies
- Work can be broken into trackable items
References
references/template.md- Spec template + review dimensions
File Location
docs/features/{feature}/
├── tech-spec.md # Technical spec
├── requests/ # Request documents
└── README.md # Feature description
Examples
Input: /tech-spec "Implement user asset snapshot feature"
Action: Requirement clarification -> Code research -> Solution design -> Output document
Input: /review-spec docs/features/xxx/tech-spec.md
Action: Read -> Research -> Review -> Output report + Gate