@zhuan-ai/zhuanspec 1.3.0 → 2.1.0
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/README.zh.md +1 -1
- package/dist/cli/index.js +1 -1
- package/dist/commands/artifact-workflow.js +45 -2
- package/dist/commands/validate.d.ts +14 -0
- package/dist/commands/validate.js +160 -4
- package/dist/core/skill-discovery.d.ts +2 -2
- package/dist/core/skill-discovery.js +16 -3
- package/dist/core/task-graph/execution-planner.d.ts +17 -0
- package/dist/core/task-graph/execution-planner.js +119 -0
- package/dist/core/task-graph/index.d.ts +13 -0
- package/dist/core/task-graph/index.js +16 -0
- package/dist/core/task-graph/mermaid-renderer.d.ts +22 -0
- package/dist/core/task-graph/mermaid-renderer.js +128 -0
- package/dist/core/task-graph/task-graph.d.ts +74 -0
- package/dist/core/task-graph/task-graph.js +219 -0
- package/dist/core/task-graph/task-parser.d.ts +14 -0
- package/dist/core/task-graph/task-parser.js +111 -0
- package/dist/core/task-graph/types.d.ts +53 -0
- package/dist/core/task-graph/types.js +7 -0
- package/dist/core/task-graph/xml-renderer.d.ts +21 -0
- package/dist/core/task-graph/xml-renderer.js +81 -0
- package/dist/core/templates/agents-template.d.ts +1 -1
- package/dist/core/templates/agents-template.js +23 -0
- package/dist/core/templates/skill-templates.js +42 -0
- package/dist/core/templates/slash-command-templates.js +25 -2
- package/dist/core/templates/tasks-template.d.ts +23 -0
- package/dist/core/templates/tasks-template.js +79 -0
- package/dist/core/templates/tdd-tasks-template.d.ts +24 -0
- package/dist/core/templates/tdd-tasks-template.js +116 -0
- package/dist/core/validation/strict-rules.d.ts +60 -0
- package/dist/core/validation/strict-rules.js +287 -0
- package/dist/core/validation/types.d.ts +10 -0
- package/dist/core/validation/validator.d.ts +5 -0
- package/dist/core/validation/validator.js +103 -1
- package/package.json +22 -20
- package/schemas/spec-driven/templates/tasks.md +17 -5
|
@@ -10,16 +10,28 @@
|
|
|
10
10
|
- 避免过度匹配：简单的代码修改（如增删枚举值、修改常量）只需通用编码规范 skill
|
|
11
11
|
- 避免关键词匹配：不要仅因文件名或路径包含某些词就匹配相关 skill
|
|
12
12
|
|
|
13
|
+
@depends 标注指南：
|
|
14
|
+
1. 分析任务间的依赖关系，识别哪些任务必须在其他任务完成后才能开始
|
|
15
|
+
2. 使用 @depends:taskId 标注依赖，支持多依赖 @depends:taskId1,taskId2
|
|
16
|
+
3. 无 @depends 标注的任务默认无依赖，可与其他无依赖任务并行执行
|
|
17
|
+
4. 依赖可以跨任务组（如 2.1 依赖 1.2）
|
|
18
|
+
5. 不允许循环依赖
|
|
19
|
+
6. 标注原则：
|
|
20
|
+
- 仅标注直接依赖：如 A→B→C，C 只需标注 @depends:B，无需标注 A
|
|
21
|
+
- 数据依赖：后续任务使用前序任务创建的表/接口/类时，必须标注依赖
|
|
22
|
+
- 独立任务：无数据或逻辑依赖的任务不要添加 @depends，以最大化并行度
|
|
23
|
+
|
|
13
24
|
示例：
|
|
14
|
-
- [ ] 1.1 新增 AssBusinessDataEnum 枚举值 ASSEMBLY_MACHINE_FLAG
|
|
15
|
-
- [ ] 1.2
|
|
16
|
-
- [ ] 1.3
|
|
25
|
+
- [ ] 1.1 新增 AssBusinessDataEnum 枚举值 ASSEMBLY_MACHINE_FLAG @skill:kf-backend-coding-standards
|
|
26
|
+
- [ ] 1.2 创建数据库表 ass_order @skill:java-db-schema-standards
|
|
27
|
+
- [ ] 1.3 编写 DAO 层代码 @skill:java-dao-standards @depends:1.2
|
|
28
|
+
- [ ] 1.4 定义 SCF 接口 IAssQueryService @skill:java-scf-rpc-usage-skill @depends:1.3
|
|
17
29
|
-->
|
|
18
30
|
|
|
19
31
|
- [ ] 1.1 <!-- 任务描述 --> <!-- @skill:real-skill-name -->
|
|
20
|
-
- [ ] 1.2 <!-- 任务描述 -->
|
|
32
|
+
- [ ] 1.2 <!-- 任务描述 --> <!-- @skill:real-skill-name @depends:1.1 -->
|
|
21
33
|
|
|
22
34
|
## 2. <!-- 任务组名称 -->
|
|
23
35
|
|
|
24
36
|
- [ ] 2.1 <!-- 任务描述 -->
|
|
25
|
-
- [ ] 2.2 <!-- 任务描述 -->
|
|
37
|
+
- [ ] 2.2 <!-- 任务描述 --> <!-- @depends:1.2,2.1 -->
|