kiro-spec-engine 1.0.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/CHANGELOG.md +60 -0
- package/LICENSE +21 -0
- package/README.md +242 -0
- package/README.zh.md +242 -0
- package/bin/kiro-spec-engine.js +229 -0
- package/lib/commands/doctor.js +59 -0
- package/lib/i18n.js +79 -0
- package/lib/python-checker.js +209 -0
- package/locales/en.json +114 -0
- package/locales/zh.json +114 -0
- package/package.json +78 -0
- package/template/.kiro/README.md +288 -0
- package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +134 -0
- package/template/.kiro/steering/CORE_PRINCIPLES.md +140 -0
- package/template/.kiro/steering/CURRENT_CONTEXT.md +85 -0
- package/template/.kiro/steering/ENVIRONMENT.md +115 -0
- package/template/.kiro/steering/RULES_GUIDE.md +46 -0
- package/template/.kiro/tools/ultrawork_enhancer.py +676 -0
- package/template/README.md +109 -0
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# 测试项目
|
|
2
|
+
|
|
3
|
+
## 🎯 项目概述
|
|
4
|
+
|
|
5
|
+
这是一个集成了 **Sisyphus Ultrawork 精神** 的 Kiro Spec 驱动开发项目。
|
|
6
|
+
|
|
7
|
+
### 核心特性
|
|
8
|
+
|
|
9
|
+
- ✅ **Spec 驱动开发**: Requirements → Design → Tasks 标准流程
|
|
10
|
+
- ✅ **Ultrawork 精神**: 像西西弗斯一样不懈努力，追求专业级质量
|
|
11
|
+
- ✅ **质量增强工具**: 自动评估和改进文档质量 (0-10 评分)
|
|
12
|
+
- ✅ **便捷脚本**: 一键应用 Ultrawork 增强
|
|
13
|
+
|
|
14
|
+
## 🚀 快速开始
|
|
15
|
+
|
|
16
|
+
### 1. 项目初始化（仅首次使用）
|
|
17
|
+
|
|
18
|
+
如果这是从模板复制的新项目，请先运行：
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
.\setup-project.bat
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
这个脚本会初始化 `.kiro` 目录的配置，更新项目名称。
|
|
25
|
+
|
|
26
|
+
### 2. 创建和增强 Spec
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
# 创建 Spec 目录
|
|
30
|
+
mkdir .kiro\specs\01-00-your-feature-name
|
|
31
|
+
|
|
32
|
+
# 编写基础 requirements.md
|
|
33
|
+
# (手动创建基本需求文档)
|
|
34
|
+
|
|
35
|
+
# 应用 Ultrawork 增强
|
|
36
|
+
python .kiro\tools\ultrawork_enhancer.py requirements .kiro\specs\01-00-your-feature-name\requirements.md
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### 3. 完整工作流
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
# 增强需求文档
|
|
43
|
+
python .kiro\tools\ultrawork_enhancer.py requirements .kiro\specs\spec-name\requirements.md
|
|
44
|
+
|
|
45
|
+
# 增强设计文档
|
|
46
|
+
python .kiro\tools\ultrawork_enhancer.py design .kiro\specs\spec-name\design.md .kiro\specs\spec-name\requirements.md
|
|
47
|
+
|
|
48
|
+
# 检查任务完成情况
|
|
49
|
+
python .kiro\tools\ultrawork_enhancer.py tasks .kiro\specs\spec-name\tasks.md
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## 📊 质量标准
|
|
53
|
+
|
|
54
|
+
### Requirements 阶段 (0-10 分)
|
|
55
|
+
- 基础结构、EARS 格式、用户故事
|
|
56
|
+
- 验收标准、非功能需求、约束条件
|
|
57
|
+
|
|
58
|
+
### Design 阶段 (0-10 分)
|
|
59
|
+
- 系统概述、架构设计、组件设计
|
|
60
|
+
- 需求追溯、技术选型、接口定义
|
|
61
|
+
|
|
62
|
+
### Tasks 阶段
|
|
63
|
+
- 完成率分析、优先级识别
|
|
64
|
+
- Ultrawork 激励、执行建议
|
|
65
|
+
|
|
66
|
+
## 🛠️ 核心脚本
|
|
67
|
+
|
|
68
|
+
### setup-project.bat
|
|
69
|
+
**作用**: 初始化 `.kiro` 目录配置
|
|
70
|
+
- 更新项目名称
|
|
71
|
+
- 检查工具完整性
|
|
72
|
+
- 提供使用指导
|
|
73
|
+
|
|
74
|
+
## 🛠️ 核心工具
|
|
75
|
+
|
|
76
|
+
### ultrawork_enhancer.py
|
|
77
|
+
**作用**: Ultrawork 质量增强核心工具
|
|
78
|
+
- 自动评估文档质量 (0-10 评分)
|
|
79
|
+
- 识别和应用改进点
|
|
80
|
+
- 支持 Requirements/Design/Tasks 三阶段
|
|
81
|
+
|
|
82
|
+
**使用方法**:
|
|
83
|
+
```bash
|
|
84
|
+
# Requirements 阶段
|
|
85
|
+
python .kiro\tools\ultrawork_enhancer.py requirements <path-to-requirements.md>
|
|
86
|
+
|
|
87
|
+
# Design 阶段
|
|
88
|
+
python .kiro\tools\ultrawork_enhancer.py design <path-to-design.md> <path-to-requirements.md>
|
|
89
|
+
|
|
90
|
+
# Tasks 阶段
|
|
91
|
+
python .kiro\tools\ultrawork_enhancer.py tasks <path-to-tasks.md>
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## 🔥 Ultrawork 精神
|
|
95
|
+
|
|
96
|
+
> 像西西弗斯推石上山一样，永不放弃，不懈努力，直到任务完美完成
|
|
97
|
+
|
|
98
|
+
- **不满足于"差不多"**: 追求专业级质量标准 (9.0/10)
|
|
99
|
+
- **持续改进**: 自动识别和应用改进点
|
|
100
|
+
- **永不放弃**: 遇到困难时提供激励和解决方案
|
|
101
|
+
|
|
102
|
+
## 📚 参考文档
|
|
103
|
+
|
|
104
|
+
- `.kiro/README.md` - Kiro 系统说明
|
|
105
|
+
- `.kiro/steering/CORE_PRINCIPLES.md` - 核心原则（包含 Ultrawork 精神）
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
**让每个 Spec 都体现 Sisyphus 的不懈努力精神！** 🔥
|