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.
- package/README.md +79 -0
- package/bin/specwf.js +2 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +1800 -0
- package/dist/templates/agents/archiver.md +112 -0
- package/dist/templates/agents/executor.md +125 -0
- package/dist/templates/agents/planner.md +114 -0
- package/dist/templates/agents/researcher.md +104 -0
- package/dist/templates/agents/reviewer.md +98 -0
- package/dist/templates/agents/verifier.md +129 -0
- package/dist/templates/artifacts/context.md +151 -0
- package/dist/templates/artifacts/design.md +224 -0
- package/dist/templates/artifacts/goal-review.md +95 -0
- package/dist/templates/artifacts/project.yml +117 -0
- package/dist/templates/artifacts/proposal.md +124 -0
- package/dist/templates/artifacts/quality-review.md +131 -0
- package/dist/templates/artifacts/research.md +127 -0
- package/dist/templates/artifacts/spec-review.md +84 -0
- package/dist/templates/artifacts/state.md +158 -0
- package/dist/templates/artifacts/summary.md +129 -0
- package/dist/templates/artifacts/tasks.md +109 -0
- package/dist/templates/artifacts/verification.md +113 -0
- package/dist/templates/commands/adhoc.md +38 -0
- package/dist/templates/commands/apply.md +20 -0
- package/dist/templates/commands/archive.md +21 -0
- package/dist/templates/commands/continue.md +27 -0
- package/dist/templates/commands/discuss.md +24 -0
- package/dist/templates/commands/grill.md +24 -0
- package/dist/templates/commands/init.md +20 -0
- package/dist/templates/commands/milestone.md +27 -0
- package/dist/templates/commands/plan.md +22 -0
- package/dist/templates/commands/research-phase.md +20 -0
- package/dist/templates/commands/research.md +24 -0
- package/dist/templates/commands/review.md +20 -0
- package/dist/templates/commands/roadmap.md +23 -0
- package/dist/templates/commands/ship.md +36 -0
- package/dist/templates/commands/split.md +16 -0
- package/dist/templates/commands/verify.md +22 -0
- package/dist/templates/skills/adhoc.md +53 -0
- package/dist/templates/skills/apply.md +134 -0
- package/dist/templates/skills/archive.md +109 -0
- package/dist/templates/skills/continue.md +97 -0
- package/dist/templates/skills/discuss.md +95 -0
- package/dist/templates/skills/grill.md +90 -0
- package/dist/templates/skills/init.md +116 -0
- package/dist/templates/skills/milestone.md +36 -0
- package/dist/templates/skills/plan.md +144 -0
- package/dist/templates/skills/research-phase.md +66 -0
- package/dist/templates/skills/research.md +76 -0
- package/dist/templates/skills/review.md +148 -0
- package/dist/templates/skills/roadmap.md +104 -0
- package/dist/templates/skills/ship.md +94 -0
- package/dist/templates/skills/split.md +96 -0
- package/dist/templates/skills/verify.md +147 -0
- 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
package/dist/cli.d.ts
ADDED