speccrew 0.1.0

package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/ARCHITECTURE-TEMPLATE.md

@@ -0,0 +1,240 @@
+# {{platform_name}} Architecture Conventions
+
+<cite>
+**Files Referenced in This Document**
+{{#each source_files}}
+- [{{name}}](file://{{path}})
+{{/each}}
+</cite>
+
+> **Target Audience**: devcrew-designer-{{platform_id}}, devcrew-dev-{{platform_id}}, devcrew-test-{{platform_id}}
+
+## Table of Contents
+
+1. [Introduction](#introduction)
+2. [Project Structure](#project-structure)
+3. [Core Components](#core-components)
+4. [Architecture Overview](#architecture-overview)
+5. [Detailed Component Analysis](#detailed-component-analysis)
+6. [Dependency Analysis](#dependency-analysis)
+7. [Performance Considerations](#performance-considerations)
+8. [Troubleshooting Guide](#troubleshooting-guide)
+9. [Conclusion](#conclusion)
+10. [Appendix](#appendix)
+
+## Introduction
+
+This architecture conventions document defines the layered architecture design, module organization, component interaction patterns, error handling strategies, security considerations, and performance guidelines for the {{platform_name}} platform.
+
+## Project Structure
+
+{{platform_name}} uses the following directory structure:
+
+```
+{{directory_structure}}
+```
+
+```mermaid
+graph TB
+{{#each structure_components}}
+{{id}}["{{name}}"]
+{{/each}}
+{{#each structure_relations}}
+{{from}} --> {{to}}
+{{/each}}
+```
+
+**Diagram Source**
+{{#each structure_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+**Section Source**
+{{#each project_structure_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+## Core Components
+
+### Layer Organization
+
+| Layer | Responsibility | Key Components |
+|-------|---------------|----------------|
+{{#each layers}}
+| {{name}} | {{responsibility}} | {{components}} |
+{{/each}}
+
+### Component Overview
+
+{{component_overview}}
+
+**Section Source**
+{{#each core_components_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+## Architecture Overview
+
+{{architecture_overview}}
+
+```mermaid
+graph TB
+subgraph "{{platform_name}} Architecture"
+{{#each arch_layers}}
+subgraph "{{name}}"
+{{#each components}}
+{{id}}["{{label}}"]
+{{/each}}
+end
+{{/each}}
+end
+{{#each arch_relations}}
+{{from}} --> {{to}}
+{{/each}}
+```
+
+**Diagram Source**
+{{#each architecture_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+**Section Source**
+{{#each architecture_overview_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+## Detailed Component Analysis
+
+{{#each component_analysis}}
+### {{name}}
+
+{{description}}
+
+{{#if has_diagram}}
+```mermaid
+{{diagram_type}}
+{{diagram_content}}
+```
+
+**Diagram Source**
+{{#each diagram_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+{{/if}}
+
+**Section Source**
+{{#each sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+{{/each}}
+
+## Dependency Analysis
+
+### Module Dependencies
+
+```mermaid
+graph LR
+{{#each modules}}
+{{id}}["{{name}}"]
+{{/each}}
+{{#each module_deps}}
+{{from}} --> {{to}}
+{{/each}}
+```
+
+**Diagram Source**
+{{#each dependency_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+### Dependency Rules
+
+{{#each dependency_rules}}
+- **{{from}}** → **{{to}}**: {{rule}}
+{{/each}}
+
+**Section Source**
+{{#each dependency_analysis_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+## Performance Considerations
+
+### Performance Guidelines
+
+{{#each performance_guidelines}}
+#### {{category}}
+
+{{description}}
+
+**Best Practices:**
+{{#each practices}}
+- {{this}}
+{{/each}}
+
+{{/each}}
+
+### Caching Strategy
+
+{{caching_strategy}}
+
+[This section provides general guidance, no specific file reference required]
+
+## Troubleshooting Guide
+
+{{#each troubleshooting}}
+### {{issue}}
+
+**Symptoms:**
+{{#each symptoms}}
+- {{this}}
+{{/each}}
+
+**Diagnostic Steps:**
+{{#each steps}}
+{{number}}. {{action}}
+{{/each}}
+
+**Solutions:**
+{{#each solutions}}
+- {{this}}
+{{/each}}
+
+{{/each}}
+
+**Section Source**
+{{#each troubleshooting_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}
+
+## Conclusion
+
+{{conclusion}}
+
+[This section is a summary, no specific file reference required]
+
+## Appendix
+
+### Best Practices
+
+{{#each best_practices}}
+- {{this}}
+{{/each}}
+
+### Anti-Patterns to Avoid
+
+{{#each anti_patterns}}
+- {{this}}
+{{/each}}
+
+### Related Documentation
+
+{{#each related_docs}}
+- [{{name}}]({{path}})
+{{/each}}
+
+**Section Source**
+{{#each appendix_sources}}
+- [{{name}}](file://{{path}}#L{{start}}-L{{end}})
+{{/each}}

package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/COLOR-SYSTEM-TEMPLATE.md

@@ -0,0 +1,68 @@
+<!-- AI-TAG: platform_id-ui-colors -->
+# Color System - platform_id
+
+<cite>
+**Files Referenced in This Document**
+- [styles_dir](relative_pathstyles_source_path)
+</cite>
+
+---
+
+## 1. Color System Overview
+
+> platform_id uses color_approach (e.g., CSS Variables / SCSS / Theme Provider).
+
+## 2. Theme Colors
+
+<!-- AI-TAG: THEME_COLORS -->
+
+| Color Name | CSS Variable | Light Mode | Dark Mode | Usage |
+|-----------|-------------|------------|-----------|-------|
+| name | variable | light_value | dark_value | usage |
+
+## 3. Functional Colors
+
+<!-- AI-TAG: FUNCTIONAL_COLORS -->
+
+| Function | Color Name | Value | Usage Scenario |
+|----------|-----------|-------|----------------|
+| Success | name | value | scenario |
+| Warning | name | value | scenario |
+| Error | name | value | scenario |
+| Info | name | value | scenario |
+
+## 4. Semantic Color Tokens
+
+<!-- AI-TAG: SEMANTIC_TOKENS -->
+
+| Token | Resolves To | Description |
+|-------|------------|-------------|
+| token | resolved_color | description |
+
+## 5. Typography Scale
+
+<!-- AI-TAG: TYPOGRAPHY -->
+
+| Level | Font Size | Line Height | Font Weight | Usage |
+|-------|----------|-------------|-------------|-------|
+| level | size | line_height | weight | usage |
+
+## 6. Spacing System
+
+<!-- AI-TAG: SPACING -->
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| token | value | usage |
+
+## 7. Agent Usage Guide
+
+| Agent Role | How to Use This Document |
+|-----------|------------------------|
+| Design Agent | 参考色彩和排版规范保持视觉一致性 |
+| Dev Agent | 使用 CSS 变量/Token 而非硬编码颜色值 |
+
+---
+
+**Section Source**
+- [styles_dir](relative_pathstyles_source_path)

package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/COMPONENT-LIBRARY-TEMPLATE.md

@@ -0,0 +1,86 @@
+<!-- AI-TAG: platform_id-ui-components -->
+# Component Library - platform_id
+
+<cite>
+**Files Referenced in This Document**
+- [components_dir](relative_pathcomponents_source_path)
+</cite>
+
+---
+
+## 1. Component Overview
+
+> Total: total_count components across category_count categories
+
+## 2. Component Categories
+
+<!-- AI-TAG: COMPONENT_CATEGORIES -->
+<!-- Fill a subsection for each component category discovered in the source code -->
+
+### 2.1 CategoryName Components
+
+| Component | Props | Events | Slots | Description | Source |
+|-----------|-------|--------|-------|-------------|--------|
+| ComponentName | key_props | key_events | key_slots | description | [Source](relative_pathsource_file) |
+
+## 3. Core Component API Reference
+
+<!-- AI-TAG: API_REFERENCE -->
+<!-- For each of the top 5-8 most commonly used components, provide detailed API -->
+
+### 3.1 ComponentName
+
+**Description:** description
+
+**Props:**
+
+| Prop | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| prop | type | required | default | description |
+
+**Events:**
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| event | payload_type | description |
+
+**Slots:**
+
+| Slot | Description |
+|------|-------------|
+| slot_name | description |
+
+**Usage Example:**
+
+```vue
+<!-- Provide a realistic usage example from actual project code -->
+```
+
+**Best Practices:**
+- practice_1
+- practice_2
+
+## 4. Component Composition Patterns
+
+<!-- AI-TAG: COMPOSITION_PATTERNS -->
+<!-- Document common patterns of combining components -->
+
+| Pattern Name | Components Used | Scenario | Example |
+|-------------|----------------|----------|---------|
+| pattern | components | scenario | brief_example |
+
+## 5. Agent Usage Guide
+
+<!-- AI-TAG: AGENT_GUIDE -->
+
+| Agent Role | How to Use This Document |
+|-----------|------------------------|
+| Solution Agent | 查阅组件能力边界，评估方案可行性 |
+| Design Agent | 参考组件 API 约束设计交互方案 |
+| Dev Agent | 查阅 Props/Events/Slots 实现功能 |
+| Test Agent | 根据 Props 边界和 Events 设计测试用例 |
+
+---
+
+**Section Source**
+- [components_dir](relative_pathcomponents_source_path)