speccrew 0.7.74 → 0.7.76

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.
Files changed (71) hide show
  1. package/.speccrew/agents/speccrew-feature-designer.md +4 -647
  2. package/.speccrew/agents/speccrew-product-manager.md +5 -480
  3. package/.speccrew/agents/speccrew-system-deployer.md +6 -457
  4. package/.speccrew/agents/speccrew-system-developer.md +9 -913
  5. package/.speccrew/agents/speccrew-test-manager.md +403 -1112
  6. package/.speccrew/skills/speccrew-agentflow-manager/SKILL.md +6 -149
  7. package/.speccrew/skills/speccrew-deploy-build/SKILL.md +2 -59
  8. package/.speccrew/skills/speccrew-deploy-migrate/SKILL.md +2 -64
  9. package/.speccrew/skills/speccrew-deploy-smoke-test/SKILL.md +2 -75
  10. package/.speccrew/skills/speccrew-deploy-startup/SKILL.md +2 -70
  11. package/.speccrew/skills/speccrew-dev-backend/SKILL.md +2 -381
  12. package/.speccrew/skills/speccrew-dev-desktop-electron/SKILL.md +2 -369
  13. package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +2 -362
  14. package/.speccrew/skills/speccrew-dev-frontend/SKILL.md +2 -304
  15. package/.speccrew/skills/speccrew-dev-mobile/SKILL.md +2 -294
  16. package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +2 -204
  17. package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +2 -173
  18. package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +2 -169
  19. package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +2 -173
  20. package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md +2 -251
  21. package/.speccrew/skills/speccrew-fd-feature-analyze/SKILL.md +2 -254
  22. package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +2 -748
  23. package/.speccrew/skills/speccrew-feature-designer-orchestration/SKILL.md +6 -105
  24. package/.speccrew/skills/speccrew-get-timestamp/SKILL.md +6 -33
  25. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/SKILL.md +3 -138
  26. package/.speccrew/skills/speccrew-knowledge-bizs-api-graph/SKILL.md +3 -283
  27. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md +3 -1014
  28. package/.speccrew/skills/speccrew-knowledge-bizs-identify-entries/SKILL.md +4 -343
  29. package/.speccrew/skills/speccrew-knowledge-bizs-init-features/SKILL.md +4 -235
  30. package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/SKILL.md +6 -72
  31. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/SKILL.md +3 -534
  32. package/.speccrew/skills/speccrew-knowledge-bizs-ui-graph/SKILL.md +3 -432
  33. package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/SKILL.md +4 -391
  34. package/.speccrew/skills/speccrew-knowledge-graph-query/SKILL.md +3 -98
  35. package/.speccrew/skills/speccrew-knowledge-graph-write/SKILL.md +3 -92
  36. package/.speccrew/skills/speccrew-knowledge-module-summarize/SKILL.md +3 -181
  37. package/.speccrew/skills/speccrew-knowledge-system-summarize/SKILL.md +3 -148
  38. package/.speccrew/skills/speccrew-knowledge-techs-dispatch/SKILL.md +3 -330
  39. package/.speccrew/skills/speccrew-knowledge-techs-generate/SKILL.md +6 -159
  40. package/.speccrew/skills/speccrew-knowledge-techs-generate-conventions/SKILL.md +3 -142
  41. package/.speccrew/skills/speccrew-knowledge-techs-generate-quality/SKILL.md +3 -568
  42. package/.speccrew/skills/speccrew-knowledge-techs-generate-ui-style/SKILL.md +3 -180
  43. package/.speccrew/skills/speccrew-knowledge-techs-index/SKILL.md +3 -154
  44. package/.speccrew/skills/speccrew-knowledge-techs-init/SKILL.md +3 -176
  45. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/SKILL.md +3 -135
  46. package/.speccrew/skills/speccrew-pm-knowledge-detector/SKILL.md +4 -88
  47. package/.speccrew/skills/speccrew-pm-module-initializer/SKILL.md +4 -178
  48. package/.speccrew/skills/speccrew-pm-module-matcher/SKILL.md +3 -102
  49. package/.speccrew/skills/speccrew-pm-phase0-init/SKILL.md +5 -78
  50. package/.speccrew/skills/speccrew-pm-phase1-knowledge-check/SKILL.md +5 -85
  51. package/.speccrew/skills/speccrew-pm-phase2-complexity-assess/SKILL.md +4 -100
  52. package/.speccrew/skills/speccrew-pm-phase5-subprd-dispatch/SKILL.md +14 -106
  53. package/.speccrew/skills/speccrew-pm-phase6-verify-confirm/SKILL.md +7 -84
  54. package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md +6 -66
  55. package/.speccrew/skills/speccrew-pm-requirement-assess/SKILL.md +4 -96
  56. package/.speccrew/skills/speccrew-pm-requirement-clarify/SKILL.md +4 -131
  57. package/.speccrew/skills/speccrew-pm-requirement-model/SKILL.md +6 -79
  58. package/.speccrew/skills/speccrew-pm-requirement-simple/SKILL.md +4 -76
  59. package/.speccrew/skills/speccrew-pm-sub-prd-generate/SKILL.md +3 -281
  60. package/.speccrew/skills/speccrew-product-manager-orchestration/SKILL.md +6 -165
  61. package/.speccrew/skills/speccrew-system-deployer-orchestration/SKILL.md +6 -79
  62. package/.speccrew/skills/speccrew-system-designer-orchestration/SKILL.md +2 -35
  63. package/.speccrew/skills/speccrew-system-developer-orchestration/SKILL.md +6 -98
  64. package/.speccrew/skills/speccrew-task-worker-execution/SKILL.md +6 -94
  65. package/.speccrew/skills/speccrew-team-leader-routing/SKILL.md +6 -79
  66. package/.speccrew/skills/speccrew-test-case-design/SKILL.md +2 -58
  67. package/.speccrew/skills/speccrew-test-code-gen/SKILL.md +2 -61
  68. package/.speccrew/skills/speccrew-test-manager-orchestration/SKILL.md +6 -94
  69. package/.speccrew/skills/speccrew-test-reporter/SKILL.md +2 -102
  70. package/.speccrew/skills/speccrew-test-runner/SKILL.md +3 -121
  71. package/package.json +1 -1
@@ -1,106 +1,18 @@
1
1
  ---
2
2
  name: speccrew-test-manager-orchestration
3
- version: 1.0.0
4
3
  description: Test Manager 的编排调度技能,负责执行三阶段测试工作流:测试用例设计 → 测试代码生成 → 测试执行与报告。支持单平台直接调用和多平台 Worker 并行调度。
5
4
  tools: Read, Write, Glob, Grep, Bash, Agent
6
5
  ---
7
6
 
8
- > **⚠️ MANDATORY EXECUTION PROTOCOL — READ BEFORE EXECUTING ANY BLOCK**
9
- >
10
- > **Step 1**: Load XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md` — this defines all block types and action-to-tool mappings
11
- >
12
- > **Step 2**: Execute this SKILL.md's XML workflow **block by block in document order**. For EVERY block, you MUST follow this 3-step cycle:
13
- >
14
- > ```
15
- > 🏷️ Block [ID] (action=[action]) — [desc]
16
- > 🔧 Tool: [which IDE tool to call]
17
- > ✅ Result: [output or status]
18
- > ```
19
- >
20
- > Action-to-tool mapping:
21
- > - `action="run-skill"` → Invoke via **Skill tool** (pass the `<field name="skill">` value EXACTLY)
22
- > - `action="run-script"` → Execute via **Terminal tool** (pass the `<field name="command">` value EXACTLY)
23
- > - `action="dispatch-to-worker"` → Create **Task** via **Task tool** for `speccrew-task-worker`
24
- > - `action="read-file"` → Read via **Read tool**
25
- > - `action="log"` → Output message directly
26
- > - `action="confirm"` → Present to user and wait for response
27
- >
28
- > **Step 3**: Execute ALL blocks sequentially without pausing (only stop at explicit `<event action="confirm">` blocks)
7
+ # Trigger Scenarios
29
8
 
30
- # Test Manager Orchestration
31
-
32
- Test Manager 的核心编排技能,负责:
33
-
34
- 1. **Stage Gate Verification** - 验证部署阶段已完成确认
35
- 2. **IDE Directory Detection** - 检测 IDE 目录并验证测试技能存在
36
- 3. **Preparation** - 识别迭代路径、定位输入文档、检查现有制品
37
- 4. **Knowledge Loading** - 加载功能规格、API契约、系统设计
38
- 5. **Test Case Design** - 测试用例设计(支持单平台/多平台模式)
39
- 6. **Test Code Generation** - 测试代码生成(含代码审查)
40
- 7. **Test Execution & Reporting** - 测试执行与缺陷报告
41
- 8. **Delivery Summary** - 交付总结确认
42
-
43
- ## Invocation Method
44
-
45
- **CRITICAL**: This skill is loaded directly by Test Manager Agent — do NOT invoke via Worker Agent.
46
-
47
- ```xml
48
- <block type="task" action="run-skill" desc="Test Manager orchestration workflow">
49
- <field name="skill">speccrew-test-manager-orchestration</field>
50
- </block>
51
- ```
52
-
53
- ## Input Parameters
54
-
55
- | Parameter | Type | Required | Description |
56
- |-----------|------|----------|-------------|
57
- | `workspace_path` | string | Yes | speccrew-workspace 根目录绝对路径 |
58
- | `iteration_dir` | string | Yes | 当前迭代目录路径 |
59
- | `update_progress_script` | string | Yes | update-progress.js 脚本路径 |
60
-
61
- ## Output
62
-
63
- - `status` - Execution status (success / partial / failed)
64
- - `test_cases_designed` - Number of test cases designed
65
- - `test_code_generated` - Number of test code files generated
66
- - `tests_passed` - Number of tests passed
67
- - `tests_failed` - Number of tests failed
68
- - `bug_reports` - List of bug report paths
69
- - `output_files` - List of generated/modified files
70
- - `summary` - Execution summary
71
- - `next_steps` - Suggested next actions
72
-
73
- ---
9
+ - Test Manager Agent starts the three-phase testing workflow after development confirmation
10
+ - Development stage confirmed and test case design needs to begin
11
+ - User requests test execution or test report generation
74
12
 
75
13
  ## AgentFlow Definition
76
14
 
77
15
  <!-- @agentflow: SKILL.xml -->
78
16
 
79
- ---
80
-
81
- ## CONTINUOUS EXECUTION RULES
82
-
83
- This skill MUST execute tasks continuously without unnecessary interruptions.
84
-
85
- ### FORBIDDEN Interruptions
86
-
87
- 1. DO NOT ask user "Should I continue?" after completing a subtask
88
- 2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
89
- 3. DO NOT pause to list what you plan to do next — just do it
90
- 4. DO NOT ask for confirmation before generating output files
91
- 5. DO NOT warn about "large number of files" — proceed with generation
92
- 6. DO NOT offer "Should I proceed with the remaining items?"
93
-
94
- ### When to Pause (ONLY these cases)
95
-
96
- 1. CHECKPOINT gates defined in workflow (user confirmation required by design)
97
- 2. Ambiguous requirements that genuinely need clarification
98
- 3. Unrecoverable errors that prevent further progress
99
- 4. Security-sensitive operations (e.g., deleting existing files)
100
-
101
- ### Batch Execution Behavior
102
-
103
- - When multiple items need processing, process ALL of them sequentially without asking
104
- - Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
105
- - If context window is approaching limit, save progress to checkpoint and inform user how to resume
106
- - NEVER voluntarily stop mid-batch to ask if user wants to continue
17
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
18
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.
@@ -10,109 +10,9 @@ tools: Read, Write, Glob, Grep
10
10
  - When user explicitly requests "generate test report", "create bug reports"
11
11
  - When test execution results need to be converted to human-readable reports
12
12
 
13
- # Role Positioning
14
-
15
- **Primary Role**: Test Report Generator
16
-
17
- **Responsibilities**:
18
- - Read structured test execution results from speccrew-test-runner
19
- - Generate comprehensive test reports with statistics and analysis
20
- - Generate individual bug reports for each failed test case
21
- - Perform detailed root cause analysis with impact assessment
22
- - Classify bug severity for prioritization
23
- - Output human-readable documents for stakeholders
24
-
25
- **Upstream Dependencies**: speccrew-test-runner
26
- **Downstream Consumers**: speccrew-test-manager, development teams, QA teams
27
-
28
13
  ## AgentFlow Definition
29
14
 
30
15
  <!-- @agentflow: SKILL.xml -->
31
16
 
32
- > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
33
-
34
- ## Output
35
-
36
- ### Output Files
37
-
38
- | File | Path | Description |
39
- |------|------|-------------|
40
- | Test Report | `{output_dir}/reports/{feature}-test-report.md` | Comprehensive test execution report |
41
- | Bug Reports | `{output_dir}/bugs/{feature}-bug-{seq}.md` | Individual bug report per failure |
42
-
43
- ### Output Structure
44
-
45
- ```
46
- {output_dir}/
47
- ├── reports/
48
- │ └── {feature}-test-report.md
49
- └── bugs/
50
- ├── {feature}-bug-001.md
51
- ├── {feature}-bug-002.md
52
- └── ...
53
- ```
54
-
55
- # Key Rules
56
-
57
- | Rule | Description |
58
- |------|-------------|
59
- | **Template-First Workflow** | Always copy template before filling sections |
60
- | **One Bug Per File** | Each bug gets its own report file for tracking |
61
- | **Severity Classification** | Always classify bug severity for prioritization |
62
- | **Actionable Reports** | Bug reports must include suggested fix direction |
63
- | **TC ID Traceability** | Every bug must be traced back to its TC ID |
64
- | **Root Cause Analysis** | Provide detailed analysis of failure causes |
65
- | **No Execution** | This skill does NOT execute tests, only generates reports |
66
-
67
- # Checklist
68
-
69
- - [ ] Execution results document loaded successfully
70
- - [ ] Test report generated with complete statistics
71
- - [ ] Results broken down by test dimension
72
- - [ ] Failed tests linked to corresponding bug reports
73
- - [ ] Each FAIL/ERROR has a corresponding bug report
74
- - [ ] Bug severity classified (Critical/High/Medium/Low)
75
- - [ ] Root cause analysis completed for each bug
76
- - [ ] All bug reports written to correct output path
77
- - [ ] Test report written to correct output path
78
- - [ ] Bug links updated in test report
79
-
80
- ---
81
-
82
- # Task Completion Report
83
-
84
- Upon completion (success or failure), output the following report format:
85
-
86
- ## Success Report
87
- ```
88
- ## Task Completion Report
89
- - **Status**: SUCCESS
90
- - **Task ID**: <from dispatch context, e.g., "test-reporter-web-vue">
91
- - **Platform**: <platform_id, e.g., "web-vue">
92
- - **Phase**: test_reporting
93
- - **Output Files**:
94
- - `{output_dir}/reports/{feature}-test-report.md`
95
- - `{output_dir}/bugs/{feature}-bug-{seq}.md` (if any failures)
96
- - **Summary**: Generated test report with {total} tests, {failed} bugs reported
97
- ```
98
-
99
- ## Failure Report
100
- ```
101
- ## Task Completion Report
102
- - **Status**: FAILED
103
- - **Task ID**: <from dispatch context>
104
- - **Platform**: <platform_id>
105
- - **Phase**: test_reporting
106
- - **Output Files**: <list of partial outputs or "None">
107
- - **Summary**: Test report generation failed during {step}
108
- - **Error**: <detailed error description>
109
- - **Error Category**: INPUT_MISSING | TEMPLATE_ERROR | WRITE_ERROR | BLOCKED
110
- - **Partial Outputs**: <list of files that were generated before failure, or "None">
111
- - **Recovery Hint**: <suggestion for recovery>
112
- ```
113
-
114
- **Error Category Definitions**:
115
- - `INPUT_MISSING`: Required execution results or test cases document not available
116
- - `TEMPLATE_ERROR`: Template file missing or malformed
117
- - `WRITE_ERROR`: File system error during report generation
118
- - `BLOCKED`: Blocked by missing upstream dependency
17
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
18
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.
@@ -7,130 +7,12 @@ tools: Read, Write, Bash, Glob, Grep
7
7
  # Trigger Scenarios
8
8
 
9
9
  - When speccrew-test-manager dispatches test execution after test code is confirmed
10
- - When speccrew-test-reporter needs raw execution results to generate reports
11
10
  - When user explicitly requests "run tests", "execute tests", "run test suite"
12
-
13
- # Role Positioning
14
-
15
- **Primary Role**: Test Execution Engine
16
-
17
- **Responsibilities**:
18
- - Read and validate test code files
19
- - Perform environment pre-checks (runtime, dependencies, test framework)
20
- - Execute test commands for various platforms and frameworks
21
- - Parse test framework output into structured data
22
- - Detect deviations between expected and actual results
23
- - Output structured execution results for downstream consumers
24
-
25
- **Upstream Dependencies**: speccrew-test-manager, speccrew-test-code-generator
26
- **Downstream Consumers**: speccrew-test-reporter
11
+ - When speccrew-test-reporter needs raw execution results to generate reports
27
12
 
28
13
  ## AgentFlow Definition
29
14
 
30
15
  <!-- @agentflow: SKILL.xml -->
31
16
 
32
- > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
33
-
34
- ## Output
35
-
36
- ### Output Files
37
-
38
- | File | Path | Description |
39
- |------|------|-------------|
40
- | Execution Results | `{output_dir}/{feature}-test-execution-results.md` | Structured test execution data |
41
-
42
- ### Output Format Contract
43
-
44
- The execution results document serves as the **input contract** for speccrew-test-reporter:
45
-
46
- ```yaml
47
- execution_summary:
48
- feature_name: string
49
- platform_id: string
50
- framework: string
51
- execution_date: ISO8601
52
- duration_ms: number
53
- total_tests: number
54
- passed: number
55
- failed: number
56
- errors: number
57
- skipped: number
58
- pass_rate: percentage
59
-
60
- test_results:
61
- - tc_id: string
62
- test_name: string
63
- status: PASS|FAIL|ERROR|SKIP
64
- duration_ms: number
65
- error_message: string|null
66
- stack_trace: string|null
67
- expected_result: string
68
- actual_result: string
69
-
70
- deviations:
71
- - tc_id: string
72
- type: FAIL|ERROR|SKIP|FLAKY
73
- severity: Critical|High|Medium|Low
74
- description: string
75
-
76
- environment:
77
- os: string
78
- runtime_version: string
79
- framework_version: string
80
- dependencies: list
81
- ```
82
-
83
- # Key Rules
84
-
85
- | Rule | Description |
86
- |------|-------------|
87
- | **Environment First** | Always verify environment before running tests |
88
- | **Complete Output Capture** | Capture both stdout and stderr for diagnostics |
89
- | **TC ID Traceability** | Every test result must be traced back to its TC ID |
90
- | **No Report Generation** | This skill does NOT generate human-readable reports |
91
- | **Structured Output Only** | Output must be structured data for downstream consumption |
92
- | **Runner → Reporter Contract** | Output format must match speccrew-test-reporter input expectations |
93
-
94
- # Checklist
95
-
96
- - [ ] Environment pre-check passed before execution
97
- - [ ] All test files from code plan were executed
98
- - [ ] Test results are correctly parsed from framework output
99
- - [ ] Failed tests are correctly traced back to TC IDs
100
- - [ ] Deviation classification completed for all non-PASS results
101
- - [ ] Execution results written to correct output path
102
- - [ ] Output format follows contract for speccrew-test-reporter
103
-
104
- ---
105
-
106
- # Task Completion Report
107
-
108
- Upon completion (success or failure), output the following report format:
109
-
110
- ## Success Report
111
- ```
112
- ## Task Completion Report
113
- - **Status**: SUCCESS
114
- - **Task ID**: <from dispatch context, e.g., "test-runner-web-vue">
115
- - **Platform**: <platform_id, e.g., "web-vue">
116
- - **Phase**: test_execution
117
- - **Output Files**:
118
- - `{output_dir}/{feature}-test-execution-results.md`
119
- - **Summary**: Test execution completed with {passed}/{total} passed, {failed} failed, {skipped} skipped
120
- - **Next Step**: Dispatch to speccrew-test-reporter for report generation
121
- ```
122
-
123
- ## Failure Report
124
- ```
125
- ## Task Completion Report
126
- - **Status**: FAILED
127
- - **Task ID**: <from dispatch context>
128
- - **Platform**: <platform_id>
129
- - **Phase**: test_execution
130
- - **Output Files**: <list of partial outputs or "None">
131
- - **Summary**: Test execution failed during {step}
132
- - **Error**: <detailed error description>
133
- - **Error Category**: DEPENDENCY_MISSING | BUILD_FAILURE | VALIDATION_ERROR | RUNTIME_ERROR | BLOCKED
134
- - **Partial Outputs**: <list of partially generated files or "None">
135
- - **Recovery Hint**: <suggestion for recovery, e.g., "Check test dependencies are installed and test configuration is valid">
136
- ```
17
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
18
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "speccrew",
3
- "version": "0.7.74",
3
+ "version": "0.7.76",
4
4
  "description": "Spec-Driven Development toolkit for AI-powered IDEs",
5
5
  "author": "charlesmu99",
6
6
  "repository": {