sillyspec 3.20.2 → 3.20.4

package/templates/workflows/archive-impact.yaml

@@ -1,79 +1,79 @@
-name: archive-impact
-description: 分析变更影响的模块并同步模块文档
-spec_version: 1
-
-roles:
-  - id: impact-analyzer
-    name: "影响分析"
-    task: "分析 git diff，提取变更影响模块"
-    inputs:
-      paths: [".sillyspec/changes/", ".sillyspec/docs/*/modules/"]
-      hints:
-        grep_patterns: ["_module-map", "module-impact", "git diff"]
-    outputs:
-      - path: ".sillyspec/changes/<change-name>/module-impact.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 20
-          - type: contains_sections
-            sections: ["模块影响矩阵", "未匹配文件"]
-    constraints:
-      - "以 git diff 为准（真实 > 声明）"
-      - "影响类型：逻辑变更/数据结构变更/接口变更/调用关系变更/配置变更/新增"
-      - "需要 review 标记不确定的影响"
-
-  - id: doc-syncer
-    name: "文档同步"
-    task: "根据 module-impact.md 同步更新模块索引和卡片"
-    depends_on:
-      - impact-analyzer
-    inputs:
-      from_role: impact-analyzer
-      output: module-impact
-      output_description: "变更影响分析结果，包含模块影响矩阵"
-      paths: [".sillyspec/docs/*/modules/"]
-      hints:
-        grep_patterns: ["_module-map", "module-impact"]
-    outputs:
-      - path: ".sillyspec/docs/sillyspec/modules/_module-map.yaml"
-        required: false
-        checks:
-          - type: file_exists
-      - path: ".sillyspec/docs/sillyspec/modules/<module-id>.md"
-        required: false
-        # checks 跳过：路径含动态 <module-id> 占位符，不适合静态检查
-    constraints:
-      - "结构化事实改 _module-map.yaml，语义解释改模块卡片"
-      - "人工备注区域永远保护，不覆盖"
-      - "更新前展示 diff 摘要，请用户确认"
-
-orchestration:
-  mode: sequential
-  timeout_per_role: 180
-
-checks:
-  role_level:
-    - type: file_exists
-    - type: min_lines
-      min: 10
-  workflow_level:
-    - type: file_exists
-      path: ".sillyspec/changes/<change-name>/module-impact.md"
-
-retry:
-  max_attempts: 1
-  include_failure_context: true
-  retry_scope: failed_role_only
-
-on_check_failure: prompt_retry
-
-permissions:
-  write_mode: patch_only
-  write_scope:
-    - ".sillyspec/docs/"
-    - ".sillyspec/changes/<change-name>/"
-  allow_shell: true
-  allow_network: false
-  allow_git: true
+name: archive-impact
+description: 分析变更影响的模块并同步模块文档
+spec_version: 1
+
+roles:
+  - id: impact-analyzer
+    name: "影响分析"
+    task: "分析 git diff，提取变更影响模块"
+    inputs:
+      paths: [".sillyspec/changes/", ".sillyspec/docs/*/modules/"]
+      hints:
+        grep_patterns: ["_module-map", "module-impact", "git diff"]
+    outputs:
+      - path: ".sillyspec/changes/<change-name>/module-impact.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 20
+          - type: contains_sections
+            sections: ["模块影响矩阵", "未匹配文件"]
+    constraints:
+      - "以 git diff 为准（真实 > 声明）"
+      - "影响类型：逻辑变更/数据结构变更/接口变更/调用关系变更/配置变更/新增"
+      - "需要 review 标记不确定的影响"
+
+  - id: doc-syncer
+    name: "文档同步"
+    task: "根据 module-impact.md 同步更新模块索引和卡片"
+    depends_on:
+      - impact-analyzer
+    inputs:
+      from_role: impact-analyzer
+      output: module-impact
+      output_description: "变更影响分析结果，包含模块影响矩阵"
+      paths: [".sillyspec/docs/*/modules/"]
+      hints:
+        grep_patterns: ["_module-map", "module-impact"]
+    outputs:
+      - path: ".sillyspec/docs/sillyspec/modules/_module-map.yaml"
+        required: false
+        checks:
+          - type: file_exists
+      - path: ".sillyspec/docs/sillyspec/modules/<module-id>.md"
+        required: false
+        # checks 跳过：路径含动态 <module-id> 占位符，不适合静态检查
+    constraints:
+      - "结构化事实改 _module-map.yaml，语义解释改模块卡片"
+      - "人工备注区域永远保护，不覆盖"
+      - "更新前展示 diff 摘要，请用户确认"
+
+orchestration:
+  mode: sequential
+  timeout_per_role: 180
+
+checks:
+  role_level:
+    - type: file_exists
+    - type: min_lines
+      min: 10
+  workflow_level:
+    - type: file_exists
+      path: ".sillyspec/changes/<change-name>/module-impact.md"
+
+retry:
+  max_attempts: 1
+  include_failure_context: true
+  retry_scope: failed_role_only
+
+on_check_failure: prompt_retry
+
+permissions:
+  write_mode: patch_only
+  write_scope:
+    - ".sillyspec/docs/"
+    - ".sillyspec/changes/<change-name>/"
+  allow_shell: true
+  allow_network: false
+  allow_git: true

package/templates/workflows/scan-docs.yaml

@@ -1,132 +1,132 @@
-name: scan-docs
-description: 并行生成项目的扫描文档（7份）
-spec_version: 1
-
-roles:
-  - id: arch
-    name: "技术架构"
-    task: "生成 ARCHITECTURE.md"
-    inputs:
-      paths:
-        - "src/*.js"
-        - "package.json"
-      hints:
-        grep_patterns: ["class ", "export ", "import ", "schema", "CREATE TABLE"]
-    outputs:
-      - path: "{SPEC_ROOT}/docs/<project>/scan/ARCHITECTURE.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 20
-          - type: contains_sections
-            sections: ["技术栈", "架构概览"]
-    constraints:
-      - "禁止读源码全文，只用 grep/rg 搜索"
-      - "Schema 只记表名+说明+字段数"
-
-  - id: conventions
-    name: "代码约定"
-    task: "生成 CONVENTIONS.md"
-    inputs:
-      paths: ["src/"]
-      hints:
-        grep_patterns: ["function ", "const ", "async ", "try ", "catch "]
-    outputs:
-      - path: "{SPEC_ROOT}/docs/<project>/scan/CONVENTIONS.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 15
-          - type: contains_sections
-            sections: ["框架隐形规则", "代码风格"]
-    constraints:
-      - "禁止读源码全文"
-      - "提取 3-5 个典型模式"
-
-  - id: structure
-    name: "目录结构+外部集成"
-    task: "生成 STRUCTURE.md 和 INTEGRATIONS.md"
-    inputs:
-      paths: ["./"]
-      hints:
-        grep_patterns: ["fetch", "http", "WebSocket", "ws", "chokidar"]
-    outputs:
-      - path: "{SPEC_ROOT}/docs/<project>/scan/STRUCTURE.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 15
-      - path: "{SPEC_ROOT}/docs/<project>/scan/INTEGRATIONS.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 15
-    constraints:
-      - "STRUCTURE: 目录树+模块说明"
-      - "INTEGRATIONS: 按类型分组外部依赖"
-
-  - id: quality
-    name: "测试+债务+概览"
-    task: "生成 TESTING.md、CONCERNS.md、PROJECT.md"
-    inputs:
-      paths: ["src/", "packages/"]
-      hints:
-        grep_patterns: ["TODO", "FIXME", "deprecated", "test", "describe"]
-    outputs:
-      - path: "{SPEC_ROOT}/docs/<project>/scan/TESTING.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 10
-          - type: no_placeholder
-      - path: "{SPEC_ROOT}/docs/<project>/scan/CONCERNS.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 10
-          - type: contains_sections
-            sections: ["代码质量", "依赖风险"]
-      - path: "{SPEC_ROOT}/docs/<project>/scan/PROJECT.md"
-        required: true
-        checks:
-          - type: file_exists
-          - type: min_lines
-            min: 15
-          - type: contains_sections
-            sections: ["项目简介", "技术栈"]
-    constraints:
-      - "CONCERNS 按严重程度分组（🔴/🟡/🟢）"
-      - "不编造不存在的测试"
-
-orchestration:
-  mode: parallel
-  max_concurrent: 4
-  timeout_per_role: 120
-
-checks:
-  workflow_level:
-    - type: file_count
-      path: "scan/"
-      min: 7
-    - type: no_empty_files
-
-retry:
-  max_attempts: 1
-  include_failure_context: true
-  retry_scope: failed_role_only
-
-on_check_failure: prompt_retry
-
-permissions:
-  write_mode: direct
-  write_scope:
-    - "{SPEC_ROOT}/docs/<project>/scan/"
-  allow_shell: true
-  allow_network: false
-  allow_git: false
+name: scan-docs
+description: 并行生成项目的扫描文档（7份）
+spec_version: 1
+
+roles:
+  - id: arch
+    name: "技术架构"
+    task: "生成 ARCHITECTURE.md"
+    inputs:
+      paths:
+        - "src/*.js"
+        - "package.json"
+      hints:
+        grep_patterns: ["class ", "export ", "import ", "schema", "CREATE TABLE"]
+    outputs:
+      - path: "{SPEC_ROOT}/docs/<project>/scan/ARCHITECTURE.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 20
+          - type: contains_sections
+            sections: ["技术栈", "架构概览"]
+    constraints:
+      - "禁止读源码全文，只用 grep/rg 搜索"
+      - "Schema 只记表名+说明+字段数"
+
+  - id: conventions
+    name: "代码约定"
+    task: "生成 CONVENTIONS.md"
+    inputs:
+      paths: ["src/"]
+      hints:
+        grep_patterns: ["function ", "const ", "async ", "try ", "catch "]
+    outputs:
+      - path: "{SPEC_ROOT}/docs/<project>/scan/CONVENTIONS.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 15
+          - type: contains_sections
+            sections: ["框架隐形规则", "代码风格"]
+    constraints:
+      - "禁止读源码全文"
+      - "提取 3-5 个典型模式"
+
+  - id: structure
+    name: "目录结构+外部集成"
+    task: "生成 STRUCTURE.md 和 INTEGRATIONS.md"
+    inputs:
+      paths: ["./"]
+      hints:
+        grep_patterns: ["fetch", "http", "WebSocket", "ws", "chokidar"]
+    outputs:
+      - path: "{SPEC_ROOT}/docs/<project>/scan/STRUCTURE.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 15
+      - path: "{SPEC_ROOT}/docs/<project>/scan/INTEGRATIONS.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 15
+    constraints:
+      - "STRUCTURE: 目录树+模块说明"
+      - "INTEGRATIONS: 按类型分组外部依赖"
+
+  - id: quality
+    name: "测试+债务+概览"
+    task: "生成 TESTING.md、CONCERNS.md、PROJECT.md"
+    inputs:
+      paths: ["src/", "packages/"]
+      hints:
+        grep_patterns: ["TODO", "FIXME", "deprecated", "test", "describe"]
+    outputs:
+      - path: "{SPEC_ROOT}/docs/<project>/scan/TESTING.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 10
+          - type: no_placeholder
+      - path: "{SPEC_ROOT}/docs/<project>/scan/CONCERNS.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 10
+          - type: contains_sections
+            sections: ["代码质量", "依赖风险"]
+      - path: "{SPEC_ROOT}/docs/<project>/scan/PROJECT.md"
+        required: true
+        checks:
+          - type: file_exists
+          - type: min_lines
+            min: 15
+          - type: contains_sections
+            sections: ["项目简介", "技术栈"]
+    constraints:
+      - "CONCERNS 按严重程度分组（🔴/🟡/🟢）"
+      - "不编造不存在的测试"
+
+orchestration:
+  mode: parallel
+  max_concurrent: 4
+  timeout_per_role: 120
+
+checks:
+  workflow_level:
+    - type: file_count
+      path: "scan/"
+      min: 7
+    - type: no_empty_files
+
+retry:
+  max_attempts: 1
+  include_failure_context: true
+  retry_scope: failed_role_only
+
+on_check_failure: prompt_retry
+
+permissions:
+  write_mode: direct
+  write_scope:
+    - "{SPEC_ROOT}/docs/<project>/scan/"
+  allow_shell: true
+  allow_network: false
+  allow_git: false