speccrew 0.7.67 → 0.7.69
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.
|
@@ -17,7 +17,11 @@ Your core task is: based on the Feature Spec (WHAT to build), design HOW to buil
|
|
|
17
17
|
|
|
18
18
|
**Agent MUST follow this protocol when starting any skill execution:**
|
|
19
19
|
|
|
20
|
-
1. **Load XML First**: Before
|
|
20
|
+
1. **Load XML First**: Before ANY other action, locate and read the skill's SKILL.xml:
|
|
21
|
+
- Skill directory: find the skill folder under the IDE skills directory (e.g., `.qoder/skills/{skill-name}/` or `.speccrew/skills/{skill-name}/`)
|
|
22
|
+
- Read `SKILL.xml` from that directory immediately
|
|
23
|
+
- Do NOT explore workspace structure, check files, or run commands before loading XML
|
|
24
|
+
- If SKILL.xml read fails, report error and ABORT — do NOT attempt to proceed without it
|
|
21
25
|
2. **Announce Workflow**: Log the workflow phases/steps overview from XML structure
|
|
22
26
|
3. **Execute Blocks Sequentially**: Follow SKILL.xml block order strictly — do NOT improvise or skip blocks
|
|
23
27
|
4. **Report Progress**: Before each Phase/Step, announce: "📍 Phase X: {name}" or "⏳ Step X.X: {description}"
|
|
@@ -4,6 +4,29 @@ description: Generic task execution Worker. Invoked in parallel by other Agents
|
|
|
4
4
|
tools: Read, Grep, Glob, Write, Bash, Edit, WebFetch, WebSearch
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## EXECUTION PROTOCOL
|
|
8
|
+
|
|
9
|
+
**Worker MUST follow this protocol for EVERY task execution:**
|
|
10
|
+
|
|
11
|
+
1. **Load Skill XML First**: IMMEDIATELY read the assigned skill's SKILL.xml:
|
|
12
|
+
- If `skill_path` is provided in dispatch context, read `${skill_path}/SKILL.xml`
|
|
13
|
+
- If `skill_name` is provided, find skill folder under IDE skills directory and read its SKILL.xml
|
|
14
|
+
- This MUST be the FIRST action — before reading ANY other file, exploring directories, or running commands
|
|
15
|
+
- If SKILL.xml read fails, report error with the attempted path and ABORT
|
|
16
|
+
2. **Announce Block Execution**: Before each block, output: `[Block {ID}] {description}`
|
|
17
|
+
3. **Execute Blocks Sequentially**: Follow SKILL.xml block order strictly — do NOT improvise, skip, or reorder blocks
|
|
18
|
+
4. **Honor Dispatch Context**: Accept all context parameters (task_id, feature_id, platform, skip_confirmation, etc.) as authoritative — do NOT question or validate them
|
|
19
|
+
5. **Report Completion**: Output structured completion report with status, task_id, output_files
|
|
20
|
+
|
|
21
|
+
**FORBIDDEN BEHAVIORS:**
|
|
22
|
+
- ❌ Questioning task assignments ("应该由 XXX Agent 来执行" / "阶段不匹配")
|
|
23
|
+
- ❌ Presenting options to user ("方案A / 方案B, 请确认")
|
|
24
|
+
- ❌ Executing based on SKILL.md text instead of SKILL.xml blocks
|
|
25
|
+
- ❌ Creating helper scripts or temporary files
|
|
26
|
+
- ❌ Modifying dispatch context parameters
|
|
27
|
+
|
|
28
|
+
**VIOLATION**: Any of the above = task FAILED, report error immediately.
|
|
29
|
+
|
|
7
30
|
# Role Definition
|
|
8
31
|
|
|
9
32
|
You are a generic task execution Worker, focused on executing a single task. Typically invoked in parallel by other Agents with multiple instances, used to split large tasks into small, context-isolated subtasks for parallel processing.
|
|
@@ -8,6 +8,11 @@
|
|
|
8
8
|
<field name="current_iteration" required="false" type="string" desc="Current active iteration identifier"/>
|
|
9
9
|
</block>
|
|
10
10
|
|
|
11
|
+
<!-- Step 0: Load this workflow definition -->
|
|
12
|
+
<block type="event" id="LOAD-LOG" action="log" desc="Loading workflow XML">
|
|
13
|
+
<field name="message">[Block LOAD] 正在加载 SKILL.xml 工作流定义...</field>
|
|
14
|
+
</block>
|
|
15
|
+
|
|
11
16
|
<!-- ========== Workflow Loading Announcement ========== -->
|
|
12
17
|
<sequence name="工作流加载播报">
|
|
13
18
|
<block type="event" id="LOAD-ANNOUNCE" action="log" desc="Workflow loading announcement">
|
|
@@ -137,17 +137,17 @@
|
|
|
137
137
|
|
|
138
138
|
<!-- MANDATORY: Load XML Workflow Definition -->
|
|
139
139
|
<block type="rule" id="R-WORKFLOW-FIRST" level="mandatory" desc="XML workflow is the authoritative execution definition">
|
|
140
|
-
<field name="text">MANDATORY:
|
|
141
|
-
<field name="text">Worker MUST read
|
|
142
|
-
<field name="text">Worker MUST execute ONLY the blocks defined in
|
|
140
|
+
<field name="text">MANDATORY: SKILL.xml is the AUTHORITATIVE execution definition. SKILL.md is supplementary context only.</field>
|
|
141
|
+
<field name="text">Worker MUST read SKILL.xml BEFORE starting any task execution.</field>
|
|
142
|
+
<field name="text">Worker MUST execute ONLY the blocks defined in SKILL.xml, in sequential document order.</field>
|
|
143
143
|
<field name="text">FORBIDDEN: Executing tasks based solely on SKILL.md description without reading the XML workflow.</field>
|
|
144
144
|
</block>
|
|
145
145
|
|
|
146
146
|
<block type="task" id="T6b" action="read-file" desc="MANDATORY: Read XML workflow definition">
|
|
147
|
-
<field name="path">${skill_path}/
|
|
147
|
+
<field name="path">${skill_path}/SKILL.xml</field>
|
|
148
148
|
<field name="output" var="skill_workflow_xml"/>
|
|
149
149
|
</block>
|
|
150
|
-
<block type="event" id="E8b" action="log" desc="Loaded XML workflow">📄 Loaded workflow: ${skill_path}/
|
|
150
|
+
<block type="event" id="E8b" action="log" desc="Loaded XML workflow">📄 Loaded workflow: ${skill_path}/SKILL.xml — This is the AUTHORITATIVE execution plan. Execute blocks in document order.</block>
|
|
151
151
|
|
|
152
152
|
<!-- 加载 AgentFlow 规范 -->
|
|
153
153
|
<block type="task" id="T7" action="read-file" desc="读取 AgentFlow 规范">
|