specwf 0.2.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.
Files changed (55) hide show
  1. package/README.md +79 -0
  2. package/bin/specwf.js +2 -0
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +1800 -0
  5. package/dist/templates/agents/archiver.md +112 -0
  6. package/dist/templates/agents/executor.md +125 -0
  7. package/dist/templates/agents/planner.md +114 -0
  8. package/dist/templates/agents/researcher.md +104 -0
  9. package/dist/templates/agents/reviewer.md +98 -0
  10. package/dist/templates/agents/verifier.md +129 -0
  11. package/dist/templates/artifacts/context.md +151 -0
  12. package/dist/templates/artifacts/design.md +224 -0
  13. package/dist/templates/artifacts/goal-review.md +95 -0
  14. package/dist/templates/artifacts/project.yml +117 -0
  15. package/dist/templates/artifacts/proposal.md +124 -0
  16. package/dist/templates/artifacts/quality-review.md +131 -0
  17. package/dist/templates/artifacts/research.md +127 -0
  18. package/dist/templates/artifacts/spec-review.md +84 -0
  19. package/dist/templates/artifacts/state.md +158 -0
  20. package/dist/templates/artifacts/summary.md +129 -0
  21. package/dist/templates/artifacts/tasks.md +109 -0
  22. package/dist/templates/artifacts/verification.md +113 -0
  23. package/dist/templates/commands/adhoc.md +38 -0
  24. package/dist/templates/commands/apply.md +20 -0
  25. package/dist/templates/commands/archive.md +21 -0
  26. package/dist/templates/commands/continue.md +27 -0
  27. package/dist/templates/commands/discuss.md +24 -0
  28. package/dist/templates/commands/grill.md +24 -0
  29. package/dist/templates/commands/init.md +20 -0
  30. package/dist/templates/commands/milestone.md +27 -0
  31. package/dist/templates/commands/plan.md +22 -0
  32. package/dist/templates/commands/research-phase.md +20 -0
  33. package/dist/templates/commands/research.md +24 -0
  34. package/dist/templates/commands/review.md +20 -0
  35. package/dist/templates/commands/roadmap.md +23 -0
  36. package/dist/templates/commands/ship.md +36 -0
  37. package/dist/templates/commands/split.md +16 -0
  38. package/dist/templates/commands/verify.md +22 -0
  39. package/dist/templates/skills/adhoc.md +53 -0
  40. package/dist/templates/skills/apply.md +134 -0
  41. package/dist/templates/skills/archive.md +109 -0
  42. package/dist/templates/skills/continue.md +97 -0
  43. package/dist/templates/skills/discuss.md +95 -0
  44. package/dist/templates/skills/grill.md +90 -0
  45. package/dist/templates/skills/init.md +116 -0
  46. package/dist/templates/skills/milestone.md +36 -0
  47. package/dist/templates/skills/plan.md +144 -0
  48. package/dist/templates/skills/research-phase.md +66 -0
  49. package/dist/templates/skills/research.md +76 -0
  50. package/dist/templates/skills/review.md +148 -0
  51. package/dist/templates/skills/roadmap.md +104 -0
  52. package/dist/templates/skills/ship.md +94 -0
  53. package/dist/templates/skills/split.md +96 -0
  54. package/dist/templates/skills/verify.md +147 -0
  55. package/package.json +56 -0
package/README.md ADDED
@@ -0,0 +1,79 @@
1
+ # specwf — 规格驱动开发工作流
2
+
3
+ spec-driven development workflow for AI coding agents.
4
+
5
+ specwf 融合 OpenSpec、GSD Core、Trellis 的核心能力,提供从需求探讨到交付的完整规格驱动开发工作流。
6
+
7
+ ## 安装
8
+
9
+ ```bash
10
+ npm install -g specwf
11
+ ```
12
+
13
+ ## 快速开始
14
+
15
+ ```bash
16
+ # 1. 初始化项目
17
+ specwf init
18
+
19
+ # 2. 生成平台文件
20
+ specwf update
21
+
22
+ # 3. 查看当前状态
23
+ specwf state
24
+
25
+ # 4. 查看下一步
26
+ specwf continue
27
+
28
+ # 5. 生成模板文件
29
+ specwf template proposal --name my-feature
30
+ ```
31
+
32
+ ## 工作流
33
+
34
+ ```
35
+ init → grill → research → roadmap → discuss → plan → apply → review → verify → archive → ship
36
+ ```
37
+
38
+ - **init**: 初始化 specwf 项目结构
39
+ - **grill**: 需求探讨(无限制细节提问)
40
+ - **research**: 技术调研(并行多方向)
41
+ - **roadmap**: 拆分里程碑和阶段
42
+ - **discuss**: Phase 讨论,捕获实现决策
43
+ - **plan**: Change 设计(TDD 强制)
44
+ - **apply**: 代码实现(分组子代理并发)
45
+ - **review**: 三重审查(规格/质量/目标并行)
46
+ - **verify**: 测试验证(诊断回环)
47
+ - **archive**: 归档(delta-spec 合并 + 代码认知回灌)
48
+ - **ship**: 交付(PR + 状态更新)
49
+
50
+ ## 命令
51
+
52
+ | 命令 | 说明 |
53
+ |---|---|
54
+ | `specwf init` | 初始化项目 |
55
+ | `specwf update` | 更新平台文件 |
56
+ | `specwf config` | 查看/修改配置 |
57
+ | `specwf state` | 查看状态 |
58
+ | `specwf context <step>` | 输出上下文清单 |
59
+ | `specwf continue` | 自动推进 |
60
+ | `specwf archive <change>` | 归档 change |
61
+ | `specwf list` | 列出 milestones/phases/changes |
62
+ | `specwf template <type>` | 生成模板文件 |
63
+
64
+ ## 配置
65
+
66
+ `specwf/project.yml` 中的关键配置:
67
+
68
+ - `profile`: 工作流严格度 (`lite` / `standard` / `strict`)
69
+ - `platform`: 目标平台 (`omp` / `claude-code`)
70
+ - `workflow.tdd`: TDD 强制
71
+ - `review.gate`: review 门控 (`all-pass` / `severity` / `report-only`)
72
+
73
+ ## 自举
74
+
75
+ specwf 用自身的工作流构建了自己。详见 `specwf/state.md` 了解完整构建历史和 21 项设计决策。
76
+
77
+ ## License
78
+
79
+ MIT
package/bin/specwf.js ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ import '../dist/cli.js';
package/dist/cli.d.ts ADDED
@@ -0,0 +1,2 @@
1
+
2
+ export { }