speccrew 0.6.59 → 0.6.62

package/.speccrew/skills/speccrew-knowledge-bizs-dispatch-xml/SKILL.md

@@ -330,11 +330,31 @@ Continue with knowledge base generation?
     </block>
 
     <block type="loop" id="S1b-L1" over="${platforms}" as="platform" parallel="true" max-concurrency="${max_concurrent_workers}" desc="Generate Feature inventory for each platform IN PARALLEL">
-      <!-- Step 1: Read platform mapping config -->
-      <block type="task" id="S1b-B1" action="run-script" status="pending" desc="Read platform mapping config">
-        <field name="command">node "${ide_skills_dir}/speccrew-knowledge-bizs-init-features/scripts/generate-inventory.js"</field>
-        <field name="arg">--entryDirsFile</field>
-        <field name="arg">${sync_state_bizs_dir}/entry-dirs-${platform.platformId}.json</field>
+      <!-- Step 1: Dispatch Worker to generate feature inventory -->
+      <block type="task" id="S1b-B1" action="dispatch-to-worker" status="pending" desc="Dispatch Worker to generate feature inventory">
+        <field name="worker">speccrew-knowledge-bizs-init-features-xml</field>
+        <field name="instructions">
+Generate feature inventory for the specified platform by analyzing entry directories.
+
+Requirements:
+- Read entry-dirs JSON file to get module entry directories
+- Scan source files in each entry directory
+- Generate features JSON with feature metadata
+- Output to features-{platformId}.json in sync_state_bizs_dir
+        </field>
+        <field name="context">{
+  "platformId": "${platform.platformId}",
+  "platformName": "${platform.platformName}",
+  "platformType": "${platform.platformType}",
+  "platformSubtype": "${platform.platformSubtype}",
+  "sourcePath": "${platform.sourcePath}",
+  "techIdentifier": "${platform.techIdentifier}",
+  "entryDirsFile": "${sync_state_bizs_dir}/entry-dirs-${platform.platformId}.json",
+  "outputDir": "${sync_state_bizs_dir}",
+  "workspace_path": "${workspace_path}",
+  "sync_state_bizs_dir": "${sync_state_bizs_dir}",
+  "language": "${language}"
+}</field>
         <field name="output" var="features_${platform.platformId}"/>
       </block>
 

package/.speccrew/skills/speccrew-knowledge-bizs-identify-entries-xml/SKILL.md

@@ -104,7 +104,7 @@ For each platform, generates:
         <field name="platform_type" value="${platform.platformType}"/>
         <field name="platform_subtype" value="${platform.platformSubtype}"/>
         <field name="tech_stack" value="${platform.techStack}"/>
-        <field name="logic_backend" value="Find all directories containing *Controller.java or *Controller.kt files. These are API entry directories. Module name = the business package name of the entry directory"/>
+        <field name="logic_backend" value="Find all directories containing *Controller.java or *Controller.kt files. These are API entry directories. Module name = the business package name of the entry directory. CRITICAL: Group by DIRECTORY, not by individual controller files. If multiple controllers reside in the same directory, that is ONE module with that directory as entryDirs"/>
         <field name="logic_frontend_vue_react" value="Find views/ or pages/ directories. First-level subdirectories under these directories are business modules"/>
         <field name="logic_mobile_uniapp" value="Find first-level subdirectories under pages/. Plus top-level pages-* directories (module name = directory name without pages- prefix)"/>
         <field name="logic_mobile_miniprogram" value="Find first-level subdirectories under pages/ as modules"/>
@@ -152,6 +152,23 @@ For each platform, generates:
         <field name="output" var="generated_json_path"/>
       </block>
 
+      <!-- Rule: Output JSON Format Validation -->
+      <block type="rule" id="R-FORMAT" scope="mandatory" desc="Output JSON format validation">
+        <field name="content">
+          The generated entry-dirs JSON file MUST strictly follow this structure:
+          - Root object MUST contain "modules" field (array type)
+          - Root object MUST NOT contain "businessModules", "subModules", or "components" fields
+          - Each module in "modules" array MUST have exactly two fields: "name" (string) and "entryDirs" (array of strings)
+          - For platforms with hierarchical directory structure (e.g. frontend views/system/user/), flatten into individual modules
+          - Module names should use hyphen-separated composite names for sub-modules (e.g. "system-user", "system-role")
+          - Multiple modules MUST NOT share the same entryDirs value. If multiple business areas share the same directory, they belong to ONE module.
+          - If the generated JSON does not match this format, you MUST regenerate it before proceeding
+        </field>
+        <field name="text">The ONLY output file from this skill is the entry-dirs JSON file specified in the output path.</field>
+        <field name="text">DO NOT generate any additional files such as reports (.md), logs, or summaries.</field>
+        <field name="text">Any extra files beyond the entry-dirs JSON are considered errors.</field>
+      </block>
+
       <!-- Checkpoint: Persist Generated JSON -->
       <block type="checkpoint" id="CP1" name="entry-dirs-generated" desc="Verify entry-dirs JSON was generated">
         <field name="file" value="${sync_state_bizs_dir}/entry-dirs-${platform.platformId}.json"/>
@@ -227,6 +244,45 @@ For each platform, generates:
 }
 ```
 
+### Module Granularity (CRITICAL)
+
+- **modules = directory-level groupings**, NOT file-level features
+- Each module represents a distinct source directory (or set of directories) containing entry files
+- **NEVER create multiple modules pointing to the SAME entryDirs** — if 10 controller files all reside in `module_admin/controller/`, that is ONE module named `admin` with entryDirs `["module_admin/controller"]`, NOT 10 separate modules
+- The downstream `generate-inventory.js` script handles file-level decomposition within each module's entryDirs — that is NOT the job of this skill
+- Module names should correspond to directory names, not individual file names
+- Typical module count for a medium project: 3-10 modules (not 30+)
+
+**Correct example** (directory-level):
+```json
+{
+  "modules": [
+    { "name": "admin", "entryDirs": ["module_admin/controller"] },
+    { "name": "ai", "entryDirs": ["module_ai/controller"] },
+    { "name": "bpm", "entryDirs": ["module_bpm/controller"] }
+  ]
+}
+```
+
+**WRONG example** (file-level — FORBIDDEN):
+```json
+{
+  "modules": [
+    { "name": "system-user", "entryDirs": ["module_admin/controller"] },
+    { "name": "system-config", "entryDirs": ["module_admin/controller"] },
+    { "name": "system-dept", "entryDirs": ["module_admin/controller"] }
+  ]
+}
+```
+
+### Format Constraints
+
+- **MUST use `modules` array** — never use `businessModules`, `components`, or any alternative field name
+- **MUST flatten hierarchy** — if a platform has sub-modules (e.g. frontend `system/user`, `system/role`), each sub-module must be a separate top-level module entry in the `modules` array
+  - 例如：`system` 有 `user` 和 `role` 子目录 → 生成 `{ "name": "system-user", "entryDirs": ["src/views/system/user"] }` 和 `{ "name": "system-role", "entryDirs": ["src/views/system/role"] }`
+- **Forbidden fields**: `businessModules`, `subModules`, `components`, `hasSubModules` — 这些都不被下游脚本支持
+- **Each module's entryDirs** must point to directories containing actual entry files (e.g. .vue, .py, .java), not parent wrapper directories
+
 ### Field Definitions
 
 - `platformId`: Platform identifier (e.g., `backend-ai`, `web-vue`, `mobile-uniapp`)

package/.speccrew/skills/speccrew-knowledge-bizs-init-features/scripts/generate-inventory.js

@@ -647,8 +647,24 @@ function main() {
       console.error('Error: entryDirsFile missing required field "sourcePath"');
       process.exit(1);
     }
+    // Check for common format mistakes
+    if (entryDirsData.businessModules && Array.isArray(entryDirsData.businessModules)) {
+      console.error('Error: entryDirsFile uses unsupported "businessModules" format.');
+      console.error('Expected: { "modules": [ { "name": "...", "entryDirs": ["..."] } ] }');
+      console.error('Received: { "businessModules": [...] }');
+      console.error('');
+      console.error('Fix: The entry-dirs JSON must use a flat "modules" array.');
+      console.error('Each module should have "name" (string) and "entryDirs" (array of strings).');
+      console.error('Sub-modules must be flattened into top-level entries.');
+      console.error('Re-run the identify-entries skill to regenerate with correct format.');
+      process.exit(1);
+    }
+
     if (!entryDirsData.modules || !Array.isArray(entryDirsData.modules)) {
-      console.error('Error: entryDirsFile missing required field "modules" array');
+      console.error('Error: entryDirsFile missing required field "modules" array.');
+      console.error('Expected format: { "platformId": "...", "modules": [ { "name": "...", "entryDirs": ["..."] } ] }');
+      const foundKeys = Object.keys(entryDirsData).join(', ');
+      console.error(`Found top-level keys: ${foundKeys}`);
       process.exit(1);
     }
     

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.6.59",
+  "version": "0.6.62",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {