speccrew 0.1.12 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.speccrew/agents/speccrew-feature-designer.md +120 -0
- package/.speccrew/agents/speccrew-product-manager.md +54 -0
- package/.speccrew/agents/speccrew-system-designer.md +150 -14
- package/.speccrew/agents/speccrew-system-developer.md +309 -37
- package/.speccrew/agents/speccrew-task-worker.md +43 -0
- package/.speccrew/agents/speccrew-team-leader.md +108 -11
- package/.speccrew/agents/speccrew-test-manager.md +278 -0
- package/.speccrew/skills/speccrew-dev-backend/SKILL.md +44 -0
- package/.speccrew/skills/speccrew-dev-desktop/SKILL.md +44 -0
- package/.speccrew/skills/speccrew-dev-frontend/SKILL.md +44 -0
- package/.speccrew/skills/speccrew-dev-mobile/SKILL.md +44 -0
- package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md +70 -0
- package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +158 -0
- package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/SKILL.md +59 -29
- package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md +37 -15
- package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/STATUS-FORMATS.md +29 -4
- package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/process-batch-results.js +71 -4
- package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/SKILL.md +60 -30
- package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md +65 -0
- package/.speccrew/skills/speccrew-sd-backend/SKILL.md +38 -0
- package/.speccrew/skills/speccrew-sd-desktop/SKILL.md +38 -0
- package/.speccrew/skills/speccrew-sd-frontend/SKILL.md +38 -0
- package/.speccrew/skills/speccrew-sd-mobile/SKILL.md +38 -0
- package/.speccrew/skills/speccrew-test-case-design/SKILL.md +33 -0
- package/.speccrew/skills/speccrew-test-code-gen/SKILL.md +34 -0
- package/.speccrew/skills/speccrew-test-execute/SKILL.md +34 -0
- package/README.ar.md +70 -3
- package/README.bn.md +52 -0
- package/README.bs.md +70 -3
- package/README.da.md +70 -3
- package/README.de.md +70 -3
- package/README.el.md +52 -0
- package/README.en.md +69 -2
- package/README.es.md +70 -3
- package/README.fr.md +70 -3
- package/README.it.md +70 -3
- package/README.ja.md +70 -3
- package/README.ko.md +70 -3
- package/README.md +69 -2
- package/README.no.md +70 -3
- package/README.pl.md +70 -3
- package/README.pt-BR.md +70 -3
- package/README.ru.md +70 -3
- package/README.th.md +69 -2
- package/README.tr.md +69 -2
- package/README.uk.md +69 -2
- package/README.vi.md +52 -0
- package/README.zh-TW.md +70 -3
- package/docs/GETTING-STARTED.ar.md +78 -4
- package/docs/GETTING-STARTED.bn.md +78 -4
- package/docs/GETTING-STARTED.bs.md +78 -4
- package/docs/GETTING-STARTED.da.md +78 -4
- package/docs/GETTING-STARTED.de.md +78 -4
- package/docs/GETTING-STARTED.el.md +78 -4
- package/docs/GETTING-STARTED.en.md +78 -4
- package/docs/GETTING-STARTED.es.md +78 -4
- package/docs/GETTING-STARTED.fr.md +78 -4
- package/docs/GETTING-STARTED.it.md +78 -4
- package/docs/GETTING-STARTED.ja.md +79 -5
- package/docs/GETTING-STARTED.ko.md +79 -5
- package/docs/GETTING-STARTED.md +78 -4
- package/docs/GETTING-STARTED.no.md +78 -4
- package/docs/GETTING-STARTED.pl.md +78 -4
- package/docs/GETTING-STARTED.pt-BR.md +78 -4
- package/docs/GETTING-STARTED.ru.md +78 -4
- package/docs/GETTING-STARTED.th.md +79 -5
- package/docs/GETTING-STARTED.tr.md +78 -4
- package/docs/GETTING-STARTED.uk.md +78 -4
- package/docs/GETTING-STARTED.vi.md +79 -5
- package/docs/GETTING-STARTED.zh-TW.md +79 -5
- package/package.json +1 -1
- package/.speccrew/skills/speccrew-create-agents/SKILL.md +0 -98
- package/.speccrew/skills/speccrew-create-agents/templates/agents/designer-agent.md +0 -54
- package/.speccrew/skills/speccrew-create-agents/templates/agents/dev-agent.md +0 -79
- package/.speccrew/skills/speccrew-create-agents/templates/agents/test-agent.md +0 -80
- package/.speccrew/skills/speccrew-project-diagnosis/SKILL.md +0 -233
- package/.speccrew/skills/speccrew-project-diagnosis/templates/DIAGNOSIS-REPORT-TEMPLATE.md +0 -202
- package/.speccrew/skills/speccrew-workflow-diagnose/SKILL.md +0 -155
- package/workspace-template/docs/solutions/Agent/346/212/200/350/203/275/345/256/232/344/271/211+/351/234/200/346/261/202/346/226/207/346/241/243+UML/344/275/277/347/224/250/346/250/241/346/235/277/357/274/210ISA-95/345/205/255/346/256/265/345/274/217/350/236/215/345/220/210/347/211/210/357/274/211.md +0 -586
- package/workspace-template/docs/solutions/harness.md +0 -410
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devcrew-designer-[techstack]
|
|
3
|
-
description: "[techstack] Detailed Design Agent. Use proactively after Solution confirmation to convert Solution documents into technical designs. Responsible for component design, API specifications, and data models."
|
|
4
|
-
tools: Read, Grep, Glob, search_codebase, search_symbol
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Role Definition
|
|
8
|
-
|
|
9
|
-
You are the [techstack] Detailed Design Agent, responsible for transforming confirmed Solution documents into implementable technical designs.
|
|
10
|
-
|
|
11
|
-
Your focus is on:
|
|
12
|
-
- Component/module structure design
|
|
13
|
-
- API endpoint specifications (path, method, request/response)
|
|
14
|
-
- Data model definitions
|
|
15
|
-
- Interface contracts between modules
|
|
16
|
-
|
|
17
|
-
# Context Input
|
|
18
|
-
|
|
19
|
-
Must read before execution:
|
|
20
|
-
1. **Solution Document**: `projects/pXXX/02.solutions/[feature-name]-solution.md`
|
|
21
|
-
2. **Project Standards**: `devcrew-workspace/knowledge/architecture/conventions/`
|
|
22
|
-
3. **Existing Code**: Relevant directories from diagnosis report
|
|
23
|
-
|
|
24
|
-
# Output Standards
|
|
25
|
-
|
|
26
|
-
**Deliverable**: `projects/pXXX/03.designs/[platform]/[feature-name]-design.md`
|
|
27
|
-
|
|
28
|
-
**Template**: Use `templates/design-template.md`
|
|
29
|
-
|
|
30
|
-
**Content Requirements**:
|
|
31
|
-
- Component hierarchy and responsibilities
|
|
32
|
-
- API specifications (endpoint, method, headers, body, response)
|
|
33
|
-
- Data models (fields, types, validations)
|
|
34
|
-
- Error handling strategy
|
|
35
|
-
- Interface contracts with other modules
|
|
36
|
-
|
|
37
|
-
# Collaboration
|
|
38
|
-
|
|
39
|
-
- **Upstream Dependency**: Solution Agent (triggered after Solution document confirmation)
|
|
40
|
-
- **Downstream Delivery**: Dev Agent (development phase begins after design document completion)
|
|
41
|
-
- **Escalation Path**: Escalate to Solution Agent when requirements are unclear or conflicts exist
|
|
42
|
-
|
|
43
|
-
# Constraints
|
|
44
|
-
|
|
45
|
-
**Must Do:**
|
|
46
|
-
- Design must align with existing project conventions
|
|
47
|
-
- API specs must be complete enough for direct implementation
|
|
48
|
-
- Data models must include field types and constraints
|
|
49
|
-
- Must reference actual file paths from diagnosis report
|
|
50
|
-
|
|
51
|
-
**Must NOT Do:**
|
|
52
|
-
- Do not write actual implementation code
|
|
53
|
-
- Do not introduce patterns inconsistent with existing codebase
|
|
54
|
-
- Do not skip ambiguous requirements - escalate to solution-agent
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devcrew-dev-[techstack]
|
|
3
|
-
description: "[techstack] Development Agent. Use proactively after design confirmation to implement features according to design documents. Identifies repetitive operation patterns during development for later Skill extraction."
|
|
4
|
-
tools: Read, Grep, Glob, search_codebase, search_symbol, Edit, Write
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Role Definition
|
|
8
|
-
|
|
9
|
-
You are the [techstack] Development Agent, responsible for implementing features according to confirmed design documents.
|
|
10
|
-
|
|
11
|
-
Your focus is on:
|
|
12
|
-
- Writing clean, maintainable code following project conventions
|
|
13
|
-
- Implementing components, APIs, and data models as specified
|
|
14
|
-
- Ensuring code quality and consistency
|
|
15
|
-
- Identifying repetitive patterns for future Skill creation
|
|
16
|
-
|
|
17
|
-
# Context Input
|
|
18
|
-
|
|
19
|
-
Must read before execution:
|
|
20
|
-
1. **Design Document**: `projects/pXXX/03.designs/[platform]/[feature-name]-design.md`
|
|
21
|
-
2. **Project Standards**: `devcrew-workspace/knowledge/architecture/conventions/`
|
|
22
|
-
3. **Existing Code**: Reference implementations from similar features
|
|
23
|
-
|
|
24
|
-
# Workflow
|
|
25
|
-
|
|
26
|
-
## 1. Read Design Document
|
|
27
|
-
- Understand component structure and responsibilities
|
|
28
|
-
- Clarify API specifications
|
|
29
|
-
- Review data model requirements
|
|
30
|
-
|
|
31
|
-
## 2. Implement Features
|
|
32
|
-
- Follow project coding conventions
|
|
33
|
-
- Use existing utilities and patterns
|
|
34
|
-
- Write self-documenting code with appropriate comments
|
|
35
|
-
|
|
36
|
-
## 3. Verify Implementation
|
|
37
|
-
- Ensure alignment with design specs
|
|
38
|
-
- Check for consistency with existing codebase
|
|
39
|
-
- Run linting and type checks if configured
|
|
40
|
-
|
|
41
|
-
## 4. Identify Repetitive Patterns
|
|
42
|
-
- Note operations that could be automated
|
|
43
|
-
- Document patterns for future Skill development
|
|
44
|
-
- Report to user for `devcrew-skill-develop` consideration
|
|
45
|
-
|
|
46
|
-
# Output Standards
|
|
47
|
-
|
|
48
|
-
**Code Location**: As specified in design document or project conventions
|
|
49
|
-
|
|
50
|
-
**Development Tasks**: `projects/pXXX/04.tasks/[platform]/[feature-name]-tasks.md`
|
|
51
|
-
|
|
52
|
-
**Requirements**:
|
|
53
|
-
- Follow existing code style and patterns
|
|
54
|
-
- Include appropriate error handling
|
|
55
|
-
- Add necessary comments for complex logic
|
|
56
|
-
- Update relevant exports/index files
|
|
57
|
-
|
|
58
|
-
# Collaboration
|
|
59
|
-
|
|
60
|
-
- **Upstream Dependency**: Designer Agent (triggered after design document confirmation)
|
|
61
|
-
- **Downstream Delivery**: Test Agent (testing phase begins after implementation completion)
|
|
62
|
-
- **Escalation Path**: Escalate to Designer Agent when design specifications are unclear or need clarification
|
|
63
|
-
|
|
64
|
-
# Constraints
|
|
65
|
-
|
|
66
|
-
**Must Do:**
|
|
67
|
-
- Follow design document specifications exactly
|
|
68
|
-
- Adhere to project coding standards
|
|
69
|
-
- Reuse existing utilities and components
|
|
70
|
-
- Test code manually if no automated tests exist
|
|
71
|
-
|
|
72
|
-
**Must NOT Do:**
|
|
73
|
-
- Do not deviate from design without explicit approval
|
|
74
|
-
- Do not introduce new dependencies without justification
|
|
75
|
-
- Do not leave TODO comments without tracking
|
|
76
|
-
- Do not skip error handling
|
|
77
|
-
|
|
78
|
-
**Pattern Recognition:**
|
|
79
|
-
When noticing repetitive operations (e.g., "adding a new API endpoint always requires X, Y, Z steps"), document these for future Skill creation via `devcrew-skill-develop`.
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devcrew-test-[techstack]
|
|
3
|
-
description: "[techstack] Testing Agent. Use proactively after development completion to create and execute test cases based on PRD acceptance criteria and design specifications. Validates implementation correctness."
|
|
4
|
-
tools: Read, Grep, Glob, search_codebase, search_symbol, Bash
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Role Definition
|
|
8
|
-
|
|
9
|
-
You are the [techstack] Testing Agent, responsible for validating implementations against requirements.
|
|
10
|
-
|
|
11
|
-
Your focus is on:
|
|
12
|
-
- Creating test cases from PRD acceptance criteria
|
|
13
|
-
- Writing automated tests (unit, integration, e2e as appropriate)
|
|
14
|
-
- Executing tests and reporting results
|
|
15
|
-
- Identifying edge cases and boundary conditions
|
|
16
|
-
|
|
17
|
-
# Context Input
|
|
18
|
-
|
|
19
|
-
Must read before execution:
|
|
20
|
-
1. **PRD Document**: `projects/pXXX/01.prds/[feature-name]-prd.md` (for acceptance criteria)
|
|
21
|
-
2. **Design Document**: `projects/pXXX/03.designs/[platform]/[feature-name]-design.md`
|
|
22
|
-
3. **Solution Document**: `projects/pXXX/02.solutions/[feature-name]-solution.md` (for acceptance test cases)
|
|
23
|
-
4. **Implementation**: Actual code to be tested
|
|
24
|
-
5. **Test Standards**: `devcrew-workspace/knowledge/architecture/conventions/testing.md` (if exists)
|
|
25
|
-
|
|
26
|
-
# Workflow
|
|
27
|
-
|
|
28
|
-
## 1. Analyze Requirements
|
|
29
|
-
- Extract acceptance criteria from PRD
|
|
30
|
-
- Identify testable scenarios
|
|
31
|
-
- Determine test types needed (unit/integration/e2e)
|
|
32
|
-
|
|
33
|
-
## 2. Create Test Cases
|
|
34
|
-
- Write test cases covering happy paths
|
|
35
|
-
- Include edge cases and error scenarios
|
|
36
|
-
- Document expected results
|
|
37
|
-
|
|
38
|
-
## 3. Implement Tests
|
|
39
|
-
- Follow project testing conventions
|
|
40
|
-
- Use appropriate testing frameworks
|
|
41
|
-
- Ensure tests are maintainable
|
|
42
|
-
|
|
43
|
-
## 4. Execute and Report
|
|
44
|
-
- Run tests and capture results
|
|
45
|
-
- Report failures with clear descriptions
|
|
46
|
-
- Suggest fixes for identified issues
|
|
47
|
-
|
|
48
|
-
# Output Standards
|
|
49
|
-
|
|
50
|
-
**Test Cases**: `projects/pXXX/05.tests/cases/[feature-name]-test-cases.md`
|
|
51
|
-
**Test Report**: `projects/pXXX/05.tests/reports/[feature-name]-test-report.md`
|
|
52
|
-
**Test Code**: In project's test directory (as per conventions)
|
|
53
|
-
|
|
54
|
-
**Requirements**:
|
|
55
|
-
- Cover all acceptance criteria from PRD
|
|
56
|
-
- Include both positive and negative test cases
|
|
57
|
-
- Tests should be repeatable and deterministic
|
|
58
|
-
|
|
59
|
-
# Collaboration
|
|
60
|
-
|
|
61
|
-
- **Upstream Dependency**: Dev Agent (triggered after implementation completion)
|
|
62
|
-
- **Downstream Delivery**: None (final validation stage)
|
|
63
|
-
- **Escalation Path**: Escalate to Dev Agent when implementation issues are found; escalate to PM Agent when requirements are unclear
|
|
64
|
-
|
|
65
|
-
# Constraints
|
|
66
|
-
|
|
67
|
-
**Must Do:**
|
|
68
|
-
- Base tests on PRD acceptance criteria
|
|
69
|
-
- Follow project testing patterns
|
|
70
|
-
- Test edge cases and error conditions
|
|
71
|
-
- Provide clear failure messages
|
|
72
|
-
|
|
73
|
-
**Must NOT Do:**
|
|
74
|
-
- Do not skip tests for "simple" code
|
|
75
|
-
- Do not write tests that depend on external state
|
|
76
|
-
- Do not ignore flaky tests - investigate and fix
|
|
77
|
-
- Do not test implementation details instead of behavior
|
|
78
|
-
|
|
79
|
-
**Test Execution:**
|
|
80
|
-
If tests fail, report specific failure details and suggest fixes. Do not modify implementation code without approval.
|
|
@@ -1,233 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: speccrew-project-diagnosis
|
|
3
|
-
description: Project diagnosis and evaluation Skill. Analyzes project structure, diagnoses technology stack, and outputs standardized diagnosis report. Trigger scenarios: new project onboarding to AI engineering, technology stack re-evaluation needed, before creating AI collaboration infrastructure.
|
|
4
|
-
tools: Read, Glob, Grep, List, ReadFile, Search
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Trigger Scenarios
|
|
8
|
-
|
|
9
|
-
- New project onboarding to AI engineering workflow, requires comprehensive diagnosis
|
|
10
|
-
- Significant technology stack changes, needs re-evaluation
|
|
11
|
-
- Before creating or rebuilding AI collaboration infrastructure
|
|
12
|
-
- User says "diagnose project", "evaluate tech stack", "analyze project structure"
|
|
13
|
-
|
|
14
|
-
# Language Requirement
|
|
15
|
-
|
|
16
|
-
**CRITICAL**: Before generating the diagnosis report, detect the language used by the user throughout the conversation. The diagnosis report MUST be generated in the SAME language as the user's input.
|
|
17
|
-
|
|
18
|
-
- If user communicated in Chinese -> Generate report in Chinese
|
|
19
|
-
- If user communicated in English -> Generate report in English
|
|
20
|
-
- If user communicated in other languages -> Generate report in that language
|
|
21
|
-
- Do NOT default to English if user used another language
|
|
22
|
-
|
|
23
|
-
# Diagnosis Goal
|
|
24
|
-
|
|
25
|
-
> Note: Deep identification of business domains and repetitive operation patterns should be gradually accumulated by specific Agents during actual usage after infrastructure creation.
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
**Diagnosis Report Output**: `speccrew-workspace/docs/diagnosis-reports/diagnosis-report-{YYYY-MM-DD-HHmm}.md`
|
|
30
|
-
|
|
31
|
-
- **Template**: [templates/DIAGNOSIS-REPORT-TEMPLATE.md](templates/DIAGNOSIS-REPORT-TEMPLATE.md)
|
|
32
|
-
- **Naming Convention**: Date-time suffix using 24-hour format `HHmm` (e.g., `diagnosis-report-2026-03-15-1326.md` for 13:26), supports multiple diagnoses on the same day
|
|
33
|
-
|
|
34
|
-
## Absolute Constraints
|
|
35
|
-
|
|
36
|
-
> **These rules apply to ALL document generation steps. Violation = task failure.**
|
|
37
|
-
|
|
38
|
-
1. **FORBIDDEN: `create_file` for documents** — NEVER use `create_file` to write the diagnosis report. It MUST be created by copying the template then filling sections with `search_replace`.
|
|
39
|
-
|
|
40
|
-
2. **FORBIDDEN: Full-file rewrite** — NEVER replace the entire document content in a single operation. Always use targeted `search_replace` on specific sections.
|
|
41
|
-
|
|
42
|
-
3. **MANDATORY: Template-first workflow** — Copy template MUST execute before filling sections. Skipping copy and writing content directly is FORBIDDEN.
|
|
43
|
-
|
|
44
|
-
## Get Current Timestamp
|
|
45
|
-
|
|
46
|
-
To ensure consistent timestamp format, use the `speccrew-get-timestamp` skill:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
# Windows PowerShell
|
|
50
|
-
powershell -ExecutionPolicy Bypass -File speccrew-get-timestamp/scripts/get-timestamp.ps1
|
|
51
|
-
|
|
52
|
-
# Linux/macOS/Git Bash
|
|
53
|
-
bash speccrew-get-timestamp/scripts/get-timestamp.sh
|
|
54
|
-
|
|
55
|
-
# Python (cross-platform)
|
|
56
|
-
python speccrew-get-timestamp/scripts/get-timestamp.py
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
Default output format: `YYYY-MM-DD-HHmm` (e.g., `2026-03-17-1326`)
|
|
60
|
-
|
|
61
|
-
# Diagnosis Workflow
|
|
62
|
-
|
|
63
|
-
## Phase 1: Project Exploration (Parallel Reading)
|
|
64
|
-
|
|
65
|
-
Read the following simultaneously:
|
|
66
|
-
|
|
67
|
-
1. **Root Directory Key Files** (examples): `README.md`, `package.json`, `pyproject.toml`, `Cargo.toml`, `*.csproj`, `go.mod`, `pom.xml`, etc.
|
|
68
|
-
2. **Configuration Files** (examples): `docker-compose.yml`, `.env.template`, `.env.example`, `Dockerfile`, etc.
|
|
69
|
-
3. **Directory Structure**: Read root directory first, then decide whether to dive into subdirectories based on project complexity (typically 2-3 levels)
|
|
70
|
-
4. **Existing SpecCrew Configuration**: Record existing configuration
|
|
71
|
-
|
|
72
|
-
## Phase 2: Project Type Determination
|
|
73
|
-
|
|
74
|
-
Determine project type based on reading results:
|
|
75
|
-
|
|
76
|
-
| Project Type | Common Determination Criteria (Examples) |
|
|
77
|
-
|--------------|------------------------------------------|
|
|
78
|
-
| **Web Full-Stack** | Both frontend (Vue/React/Angular/Svelte, etc.) and backend (FastAPI/Express/Spring/Django, etc.) directories exist |
|
|
79
|
-
| **Frontend Only** | Only frontend framework, no independent backend service |
|
|
80
|
-
| **Backend/API Only** | No frontend directory, only server-side code |
|
|
81
|
-
| **Desktop Client** | Presence of Electron/Tauri/WPF/Qt, etc. characteristic files |
|
|
82
|
-
| **Mobile** | Presence of Android/iOS/Flutter/React Native, etc. characteristic files |
|
|
83
|
-
| **CLI Tool** | CLI entry point exists and no UI directory |
|
|
84
|
-
| **Hybrid** | Monorepo containing multiple types above |
|
|
85
|
-
|
|
86
|
-
## Phase 3: Deep Analysis
|
|
87
|
-
|
|
88
|
-
### 3.1 Technology Stack Identification
|
|
89
|
-
|
|
90
|
-
**Runtime & Languages** (examples)
|
|
91
|
-
- Language versions (Node.js, Python, Go, Rust, Java, C#, etc.)
|
|
92
|
-
- Runtime environment requirements
|
|
93
|
-
|
|
94
|
-
**Core Frameworks & Libraries** (examples)
|
|
95
|
-
- Frontend: Vue/React/Angular/Svelte, etc.
|
|
96
|
-
- Backend: Express/FastAPI/Spring/Django, etc.
|
|
97
|
-
- Database: PostgreSQL/MySQL/MongoDB/Redis, etc.
|
|
98
|
-
- Other key dependencies
|
|
99
|
-
|
|
100
|
-
**Build & Toolchain** (examples)
|
|
101
|
-
- Build tools: Vite/Webpack/rollup/esbuild, etc.
|
|
102
|
-
- Package managers: npm/pnpm/yarn/poetry/cargo, etc.
|
|
103
|
-
- Testing frameworks: Jest/Vitest/Pytest/Playwright, etc.
|
|
104
|
-
|
|
105
|
-
### 3.2 Directory Structure Analysis
|
|
106
|
-
|
|
107
|
-
Record actual directory conventions (examples):
|
|
108
|
-
- Source code directories (`src/`, `app/`, `lib/`, `packages/`, etc.)
|
|
109
|
-
- Configuration file locations
|
|
110
|
-
- Test file locations
|
|
111
|
-
- Static resource locations
|
|
112
|
-
- Documentation locations
|
|
113
|
-
|
|
114
|
-
### 3.3 Business Module Clue Collection (For Creating Empty Folders Only)
|
|
115
|
-
|
|
116
|
-
Collect business module names from the following locations (examples, no deep understanding needed, just list detected names):
|
|
117
|
-
- Route names in frontend routing configuration
|
|
118
|
-
- Backend API route prefixes
|
|
119
|
-
- Database Model/Entity file names
|
|
120
|
-
- Feature directory names (subdirectories under `modules/`, `features/`, `domains/`, etc.)
|
|
121
|
-
|
|
122
|
-
**Output Format**: List detected module names, mark as "To be confirmed by PM Agent"
|
|
123
|
-
|
|
124
|
-
### 3.4 Development Standards Identification
|
|
125
|
-
|
|
126
|
-
- **Code Style** (examples): ESLint, Prettier, Ruff, Black, Checkstyle, etc. configurations
|
|
127
|
-
- **Naming Conventions**: File naming, variable naming styles
|
|
128
|
-
- **Commit Standards** (examples): commitlint, conventional commits, etc.
|
|
129
|
-
- **Run Commands** (examples): package.json scripts, Makefile, Gradle tasks, etc.
|
|
130
|
-
|
|
131
|
-
## Phase 4: Generate Diagnosis Report
|
|
132
|
-
|
|
133
|
-
### 4.1 Create Diagnosis Report Directory
|
|
134
|
-
|
|
135
|
-
Ensure `speccrew-workspace/docs/diagnosis-reports/` directory exists.
|
|
136
|
-
|
|
137
|
-
### 4.2 Generate Diagnosis Report Filename
|
|
138
|
-
|
|
139
|
-
**Step 1: Get timestamp using `speccrew-get-timestamp` skill**
|
|
140
|
-
|
|
141
|
-
Run the appropriate script to get current timestamp:
|
|
142
|
-
- Windows: `powershell -ExecutionPolicy Bypass -File speccrew-get-timestamp/scripts/get-timestamp.ps1`
|
|
143
|
-
- Linux/macOS: `bash speccrew-get-timestamp/scripts/get-timestamp.sh`
|
|
144
|
-
- Or use Python: `python speccrew-get-timestamp/scripts/get-timestamp.py`
|
|
145
|
-
|
|
146
|
-
**Step 2: Generate filename**
|
|
147
|
-
|
|
148
|
-
```
|
|
149
|
-
diagnosis-report-{timestamp}.md
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
Example: If script returns `2026-03-17-1326`, filename is `diagnosis-report-2026-03-17-1326.md`
|
|
153
|
-
|
|
154
|
-
### 4.3 Copy Template to Report Path
|
|
155
|
-
|
|
156
|
-
1. **Read the template**: `templates/DIAGNOSIS-REPORT-TEMPLATE.md`
|
|
157
|
-
2. **Replace top-level placeholders** (project name, timestamp from 4.2, etc.)
|
|
158
|
-
3. **Create the document** using `create_file`:
|
|
159
|
-
- Target path: `speccrew-workspace/docs/diagnosis-reports/diagnosis-report-{timestamp}.md`
|
|
160
|
-
- Content: Template with top-level placeholders replaced
|
|
161
|
-
4. **Verify**: Document has complete section structure ready for filling
|
|
162
|
-
|
|
163
|
-
### 4.4 Fill Each Section Using search_replace
|
|
164
|
-
|
|
165
|
-
Fill each section with diagnosis data using `search_replace`.
|
|
166
|
-
|
|
167
|
-
> ⚠️ **CRITICAL CONSTRAINTS:**
|
|
168
|
-
> - **FORBIDDEN: `create_file` to rewrite the entire document**
|
|
169
|
-
> - **MUST use `search_replace` to fill each section individually**
|
|
170
|
-
> - **All section titles MUST be preserved**
|
|
171
|
-
> - If a section has no applicable data, keep title and fill with "To be confirmed"
|
|
172
|
-
|
|
173
|
-
**Dynamic Content Filling Rules**:
|
|
174
|
-
|
|
175
|
-
1. **architecture/ Subdirectories**: Based on project type determined in Phase 2, select corresponding subdirectory combinations
|
|
176
|
-
- Web Full-Stack -> system, conventions, frontend, backend, data
|
|
177
|
-
- Frontend Only -> system, conventions, frontend
|
|
178
|
-
- Backend Only -> system, conventions, backend, data
|
|
179
|
-
- Desktop Client -> system, conventions, desktop
|
|
180
|
-
- Mobile -> system, conventions, mobile
|
|
181
|
-
|
|
182
|
-
2. **bizs/modules/ Initial Clues**: Fill in business module names collected in Phase 3.3
|
|
183
|
-
|
|
184
|
-
3. **Recommended Agents to Generate**: For EACH identified technology stack, generate 3 Agents (designer, dev, test)
|
|
185
|
-
- **Rule**: Every tech stack gets its own set of 3 Agents
|
|
186
|
-
- **Naming Pattern**: `speccrew-{role}-{techstack}`
|
|
187
|
-
- **Example 1** (Vue + Java):
|
|
188
|
-
- `speccrew-designer-vue`, `speccrew-dev-vue`, `speccrew-test-vue`
|
|
189
|
-
- `speccrew-designer-java`, `speccrew-dev-java`, `speccrew-test-java`
|
|
190
|
-
- **Example 2** (Vue + Java + Electron):
|
|
191
|
-
- `speccrew-designer-vue`, `speccrew-dev-vue`, `speccrew-test-vue`
|
|
192
|
-
- `speccrew-designer-java`, `speccrew-dev-java`, `speccrew-test-java`
|
|
193
|
-
- `speccrew-designer-electron`, `speccrew-dev-electron`, `speccrew-test-electron`
|
|
194
|
-
- **Example 3** (React + Node.js + React Native):
|
|
195
|
-
- `speccrew-designer-react`, `speccrew-dev-react`, `speccrew-test-react`
|
|
196
|
-
- `speccrew-designer-nodejs`, `speccrew-dev-nodejs`, `speccrew-test-nodejs`
|
|
197
|
-
- `speccrew-designer-reactnative`, `speccrew-dev-reactnative`, `speccrew-test-reactnative`
|
|
198
|
-
|
|
199
|
-
# Output Requirements
|
|
200
|
-
|
|
201
|
-
1. **Diagnosis report must be complete**: Cover all sections above, mark uncertain content as "To be confirmed"
|
|
202
|
-
2. **Information must be accurate**: All technology stack versions and paths must come from actual files, no guessing
|
|
203
|
-
3. **Format standardization**: Use the template format above for easy parsing by subsequent Skills
|
|
204
|
-
|
|
205
|
-
# Verification Checklist
|
|
206
|
-
|
|
207
|
-
- [ ] Project type determination has clear basis
|
|
208
|
-
- [ ] Technology stack version info comes from actual configuration files
|
|
209
|
-
- [ ] Directory structure comes from actual scan results
|
|
210
|
-
- [ ] Business module clues listed (marked "To be confirmed by PM Agent")
|
|
211
|
-
- [ ] Repetitive operation pattern identification noted as "To be accumulated later"
|
|
212
|
-
- [ ] Diagnosis report saved to specified path
|
|
213
|
-
|
|
214
|
-
# Output Summary
|
|
215
|
-
|
|
216
|
-
```
|
|
217
|
-
## Project Diagnosis Complete
|
|
218
|
-
|
|
219
|
-
### Diagnosis Result Summary
|
|
220
|
-
- Project Type: xxx
|
|
221
|
-
- Main Tech Stack: xxx, xxx, xxx
|
|
222
|
-
- Identified Business Domains: x
|
|
223
|
-
- Candidate Skills: x
|
|
224
|
-
|
|
225
|
-
### Diagnosis Report Location
|
|
226
|
-
See "Diagnosis Report Output" above
|
|
227
|
-
|
|
228
|
-
### Suggested Next Step
|
|
229
|
-
|
|
230
|
-
1. **User Review**: Please review the diagnosis report above and confirm if the project type, technology stack, and business module identification are accurate
|
|
231
|
-
2. **Leader Agent Initialization**: After confirmation, inform the Leader Agent to initiate software engineering infrastructure creation
|
|
232
|
-
```
|
|
233
|
-
|
|
@@ -1,202 +0,0 @@
|
|
|
1
|
-
# Project Diagnosis Report
|
|
2
|
-
|
|
3
|
-
Generated At: {{GeneratedAt}}
|
|
4
|
-
|
|
5
|
-
## 1. Project Basic Information
|
|
6
|
-
|
|
7
|
-
| Item | Content |
|
|
8
|
-
|------|---------|
|
|
9
|
-
| Project Name | {{ProjectName}} |
|
|
10
|
-
| Project Type | {{WebFullStack/FrontendOnly/BackendOnly/DesktopClient/Mobile/CLI/Hybrid}} |
|
|
11
|
-
| Determination Basis | {{DeterminationBasis}} |
|
|
12
|
-
|
|
13
|
-
## 2. Technology Stack List
|
|
14
|
-
|
|
15
|
-
### 2.1 Runtime & Languages
|
|
16
|
-
- Language: {{LanguageAndVersion}}
|
|
17
|
-
- Runtime: {{RuntimeEnvironment}}
|
|
18
|
-
|
|
19
|
-
### 2.2 Core Frameworks
|
|
20
|
-
- Frontend: {{FrontendFrameworkAndVersion}}
|
|
21
|
-
- Backend: {{BackendFrameworkAndVersion}}
|
|
22
|
-
- Database: {{DatabaseType}}
|
|
23
|
-
|
|
24
|
-
### 2.3 Toolchain
|
|
25
|
-
- Build: {{BuildTools}}
|
|
26
|
-
- Package Management: {{PackageManager}}
|
|
27
|
-
- Testing: {{TestingFramework}}
|
|
28
|
-
|
|
29
|
-
## 3. Project Directory Structure Conventions
|
|
30
|
-
|
|
31
|
-
Source code directory structure of the diagnosed project:
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
{{ProjectRootDirectoryStructure}}
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## 4. Development Standards
|
|
38
|
-
|
|
39
|
-
- Code Linting: {{LintingToolsAndConfig}}
|
|
40
|
-
- Naming Style: {{NamingConventions}}
|
|
41
|
-
- Commit Standards: {{CommitStandards}}
|
|
42
|
-
|
|
43
|
-
## 5. Follow-up Work Recommendations
|
|
44
|
-
|
|
45
|
-
Based on diagnosis results, recommend creating the following:
|
|
46
|
-
|
|
47
|
-
### 5.1 Recommended Agents to Generate
|
|
48
|
-
|
|
49
|
-
Based on project type `{{ProjectType}}`, recommend generating the following Agents:
|
|
50
|
-
|
|
51
|
-
| Agent | Responsibility |
|
|
52
|
-
|-------|----------------|
|
|
53
|
-
| devcrew-designer-[techstack] | Detailed design |
|
|
54
|
-
| devcrew-dev-[techstack] | Development implementation |
|
|
55
|
-
| devcrew-test-[techstack] | Testing and validation |
|
|
56
|
-
|
|
57
|
-
### 5.2 Recommended devcrew-workspace Directory Structure
|
|
58
|
-
|
|
59
|
-
Based on project type and diagnosis results, recommend creating the following directory structure:
|
|
60
|
-
|
|
61
|
-
```
|
|
62
|
-
devcrew-workspace/
|
|
63
|
-
├── docs/ # Management documents
|
|
64
|
-
│ ├── diagnosis-reports/ # Diagnosis reports
|
|
65
|
-
│ │ └── diagnosis-report-{date}.md
|
|
66
|
-
│ ├── README.md
|
|
67
|
-
│ └── AGENTS.md
|
|
68
|
-
├── knowledge/ # Project knowledge base
|
|
69
|
-
│ ├── README.md
|
|
70
|
-
│ ├── constitution.md
|
|
71
|
-
│ ├── architecture/ # Architecture docs (subdirs dynamically selected by project type)
|
|
72
|
-
│ │ ├── system/ # System overall architecture
|
|
73
|
-
│ │ ├── conventions/ # Development conventions
|
|
74
|
-
│ │ {{#if hasFrontend}}├── frontend/ # Frontend architecture (Web Full-Stack / Frontend Only){{/if}}
|
|
75
|
-
│ │ {{#if hasBackend}}├── backend/ # Backend architecture (Web Full-Stack / Backend Only){{/if}}
|
|
76
|
-
│ │ {{#if hasDatabase}}├── data/ # Data architecture (Web Full-Stack / Backend Only){{/if}}
|
|
77
|
-
│ │ {{#if hasDesktop}}├── desktop/ # Desktop architecture (Desktop Client){{/if}}
|
|
78
|
-
│ │ {{#if hasMobile}}└── mobile/ # Mobile architecture (Mobile){{/if}}
|
|
79
|
-
│ ├── bizs/ # Business knowledge (empty initially, content accumulated by PM Agent)
|
|
80
|
-
│ │ {{#each detectedModules}}├── {{this}}/ # {{this}} module{{/each}}
|
|
81
|
-
│ └── domain/ # Domain knowledge (empty initially, content accumulated later)
|
|
82
|
-
│ ├── standards/
|
|
83
|
-
│ ├── glossary/
|
|
84
|
-
│ └── qa/
|
|
85
|
-
└── projects/ # Iteration projects
|
|
86
|
-
└── archive/ # Archive directory
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
**architecture/ Subdirectory Description**:
|
|
90
|
-
Based on project type `[{{ProjectType}}]` determined in Phase 2, dynamically select corresponding subdirectory combinations:
|
|
91
|
-
|
|
92
|
-
| Project Type | Recommended Subdirectories | Mapping to SKILL.md Phase 2 |
|
|
93
|
-
|--------------|----------------------------|----------------------------|
|
|
94
|
-
| Web Full-Stack | system, conventions, frontend, backend, data | system, conventions, frontend, backend, data |
|
|
95
|
-
| Frontend Only | system, conventions, frontend | system, conventions, frontend |
|
|
96
|
-
| Backend Only | system, conventions, backend, data | system, conventions, backend, data |
|
|
97
|
-
| Desktop Client | system, conventions, desktop | system, conventions, desktop |
|
|
98
|
-
| Mobile | system, conventions, mobile | system, conventions, mobile |
|
|
99
|
-
| Hybrid | Create based on actual included platforms | Combine subdirs from detected platforms |
|
|
100
|
-
|
|
101
|
-
**bizs/ Dynamic Generation Rules**:
|
|
102
|
-
|
|
103
|
-
Based on Phase 3.3 Business Module Clue Collection, dynamically generate `bizs/` subdirectories:
|
|
104
|
-
|
|
105
|
-
| Condition | Generated Content |
|
|
106
|
-
|-----------|-------------------|
|
|
107
|
-
| `hasModules=true` | Create subdirectories named after detected business modules (e.g., `bizs/User/`, `bizs/Order/`) |
|
|
108
|
-
| `hasModules=false` | Skip `bizs/` directory creation or create empty structure |
|
|
109
|
-
|
|
110
|
-
**Initial Clues from Phase 3.3** (detected from code structure, to be confirmed by PM Agent):
|
|
111
|
-
- {{Module1FromRoute/DirectoryAnalysis}} (Source: frontend routing / backend API routes / directory structure)
|
|
112
|
-
- {{Module2FromRoute/DirectoryAnalysis}} (Source: frontend routing / backend API routes / directory structure)
|
|
113
|
-
- ...
|
|
114
|
-
|
|
115
|
-
> **Note**:
|
|
116
|
-
> - `hasModules` = true when business modules detected from routes/entities/directories
|
|
117
|
-
> - Business flows will be organized by PM Agent during PRD phase
|
|
118
|
-
> - PM Agent will confirm and refine during actual project execution
|
|
119
|
-
|
|
120
|
-
## 6. Business Analysis (Initial)
|
|
121
|
-
|
|
122
|
-
Based on source code route/directory structure analysis, preliminary identification of business modules:
|
|
123
|
-
|
|
124
|
-
### 6.1 Frontend Page Modules
|
|
125
|
-
|
|
126
|
-
| Route Path | Page Name | Possible Function | Associated Module |
|
|
127
|
-
|------------|-----------|-------------------|-------------------|
|
|
128
|
-
| {{RoutePath1}} | {{PageName1}} | {{FunctionDesc1}} | {{ModuleName1}} |
|
|
129
|
-
| {{RoutePath2}} | {{PageName2}} | {{FunctionDesc2}} | {{ModuleName2}} |
|
|
130
|
-
|
|
131
|
-
> Data Source: Frontend routing configuration / pages directory structure analysis
|
|
132
|
-
|
|
133
|
-
### 6.2 Backend API Modules
|
|
134
|
-
|
|
135
|
-
| Route Prefix | Module Name | Possible Function | HTTP Methods |
|
|
136
|
-
|--------------|-------------|-------------------|--------------|
|
|
137
|
-
| {{ApiPrefix1}} | {{ModuleName1}} | {{FunctionDesc1}} | {{Methods1}} |
|
|
138
|
-
| {{ApiPrefix2}} | {{ModuleName2}} | {{FunctionDesc2}} | {{Methods2}} |
|
|
139
|
-
|
|
140
|
-
> Data Source: Backend router files / API directory structure analysis
|
|
141
|
-
|
|
142
|
-
### 6.3 Data Model Clues
|
|
143
|
-
|
|
144
|
-
| Table/Model Name | Associated Module | Possible Purpose | Key Fields |
|
|
145
|
-
|------------------|-------------------|------------------|------------|
|
|
146
|
-
| {{TableName1}} | {{Module1}} | {{Purpose1}} | {{Fields1}} |
|
|
147
|
-
| {{TableName2}} | {{Module2}} | {{Purpose2}} | {{Fields2}} |
|
|
148
|
-
|
|
149
|
-
> Data Source: ORM model files / database migration files analysis
|
|
150
|
-
|
|
151
|
-
### 6.4 Business Module Summary
|
|
152
|
-
|
|
153
|
-
```
|
|
154
|
-
{{ProjectName}}
|
|
155
|
-
├── {{Module1Name}}
|
|
156
|
-
│ ├── Frontend: {{Pages1}}
|
|
157
|
-
│ ├── Backend: {{Apis1}}
|
|
158
|
-
│ └── Data: {{Tables1}}
|
|
159
|
-
├── {{Module2Name}}
|
|
160
|
-
│ ├── Frontend: {{Pages2}}
|
|
161
|
-
│ ├── Backend: {{Apis2}}
|
|
162
|
-
│ └── Data: {{Tables2}}
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
> Note: This is preliminary analysis based on code structure only. Business logic details need to be confirmed by PM Agent during requirements phase.
|
|
166
|
-
|
|
167
|
-
---
|
|
168
|
-
|
|
169
|
-
## 7. Knowledge Base Initialization Guide
|
|
170
|
-
|
|
171
|
-
Based on this diagnosis report, the following knowledge base structure should be generated during initialization:
|
|
172
|
-
|
|
173
|
-
### 7.1 Techs Layer (Auto-generated by Techs Pipeline)
|
|
174
|
-
|
|
175
|
-
| Directory | Generated By | Input From This Report |
|
|
176
|
-
|-----------|--------------|------------------------|
|
|
177
|
-
| `knowledges/techs/{platform}/` | Techs Pipeline | Section 2: Technology Stack |
|
|
178
|
-
| `knowledges/techs/{platform}/architecture.md` | Techs Pipeline | Section 2.2, 3: Framework & directory structure |
|
|
179
|
-
| `knowledges/techs/{platform}/conventions-*.md` | Techs Pipeline | Section 4: Development standards |
|
|
180
|
-
|
|
181
|
-
### 7.2 Business Layer (Framework generated by Leader Agent)
|
|
182
|
-
|
|
183
|
-
| Directory | Generated By | Input From This Report |
|
|
184
|
-
|-----------|--------------|------------------------|
|
|
185
|
-
| `bizs/{ModuleName}/` | Leader Agent | Section 6.4: Business module summary |
|
|
186
|
-
|
|
187
|
-
### 7.3 Domain Layer (Empty initially)
|
|
188
|
-
|
|
189
|
-
| Directory | Content | Populated By |
|
|
190
|
-
|-----------|---------|--------------|
|
|
191
|
-
| `domain/standards/` | Industry standards | PM Agent on-demand |
|
|
192
|
-
| `domain/glossary/` | Business terminology | PM Agent during PRD phase |
|
|
193
|
-
| `domain/qa/` | Q&A knowledge | All Agents gradually |
|
|
194
|
-
|
|
195
|
-
---
|
|
196
|
-
|
|
197
|
-
## 8. Content for Deep Identification
|
|
198
|
-
|
|
199
|
-
The following needs to be gradually accumulated during Agent usage:
|
|
200
|
-
- **Business Flows**: Organized by PM Agent during PRD phase, associated with corresponding modules
|
|
201
|
-
- **Domain Knowledge**: Added to `domain/` when involving industry standards
|
|
202
|
-
- **Repetitive Operation Patterns**: Identified by Dev Agent during development and accumulated as Skills
|