kiro-spec-engine 1.0.0

package/template/.kiro/steering/CORE_PRINCIPLES.md

@@ -0,0 +1,140 @@
+# 核心开发原则（基准规则）
+
+> **重要**: 这些是项目的基准规则，适用于所有 Spec，不应随意修改。
+> 场景特定的规则请参考 `CURRENT_CONTEXT.md`
+
+---
+
+## 📋 Spec 驱动开发工作流程
+
+### Spec 命名规范
+
+**格式**: `{序号}-{序号}-{简短描述}`
+
+**规则**:
+- 使用 kebab-case（小写字母，单词用连字符分隔）
+- 必须包含两个序号（用连字符分隔）
+- 描述应简洁明确，反映 Spec 核心目标
+
+**示例**:
+- ✅ `01-00-user-space-diagnosis`
+- ✅ `01-01-fix-duplicate-file-space-calculation`
+- ✅ `02-00-oauth-api-upgrade`
+- ❌ `user-space-diagnosis`（缺少序号）
+- ❌ `01-user-space-diagnosis`（只有一个序号）
+- ❌ `FixDuplicateFile`（不是 kebab-case）
+- ❌ `fix_duplicate_file`（使用下划线而非连字符）
+
+### 标准工作流程
+
+```
+1. 创建 Spec → 2. requirements.md → 3. design.md → 4. tasks.md → 5. 执行任务 → 6. 产物归档
+```
+
+### Spec 目录结构
+
+```
+.kiro/specs/{feature-name}/
+├── requirements.md, design.md, tasks.md
+├── scripts/, reports/, diagnostics/, tests/, results/
+```
+
+---
+
+## ⚠️ 核心原则
+
+### 1. Spec 驱动开发原则
+
+**任何需求都必须先建立 Spec**
+- 所有产物归档到 Spec 目录：scripts/, reports/, diagnostics/, tests/, results/
+- 禁止将脚本、测试直接放到项目根目录
+
+### 2. 文件管理原则
+
+**禁止在根目录下随意生成临时文件**
+- 临时文件用完立即删除
+- 所有产物归档到对应的 Spec 目录
+
+### 3. 代码质量原则
+
+- 代码必须能够编译通过
+- 修改后必须运行相关测试
+- 遵循项目的编码规范
+
+### 4. 🔥 Ultrawork 原则(借鉴 Sisyphus 精神)
+
+**核心理念**: 像西西弗斯推石上山一样,永不放弃,不懈努力,直到任务完美完成
+
+#### 执行标准
+- **专业级质量**: 每个阶段追求生产级标准,不满足于"差不多"
+- **不懈努力**: 遇到困难持续尝试解决方案,不轻易放弃或求助用户
+- **完整交付**: 确保输出完整、准确、可用,达到专业水准
+
+#### 各阶段 Ultrawork 要求
+- **Requirements 阶段**: 像资深产品经理一样深入思考每个用户场景,考虑边界条件、异常情况、安全性、性能等各个方面
+- **Design 阶段**: 像资深架构师一样设计每个组件,确保架构优雅、可扩展、易维护,考虑技术可行性和最佳实践
+- **Tasks 阶段**: 像资深开发者一样实现每行代码,确保代码质量、测试覆盖、文档完整
+
+#### 困难处理的 Ultrawork 精神
+- **编译错误** → 仔细分析错误信息,理解根本原因,持续修复直到通过
+- **逻辑问题** → 重新审视需求和设计,优化方案,不断迭代直到正确
+- **技术难题** → 换个思路和角度,查阅资料,寻找最佳实践,持续突破
+- **卡住不动** → 分解问题,从不同维度尝试,绝不轻易放弃
+- **永不轻易转移责任给用户,而是主动承担和解决问题**
+
+#### Ultrawork 质量标准
+- **Requirements**: 覆盖所有场景,验收标准清晰可测试,考虑非功能需求
+- **Design**: 架构合理,组件职责清晰,技术方案可行,有完整的双向追溯
+- **Tasks**: 代码编译通过,测试全部通过,文档完整,符合最佳实践
+
+### 5. 问题解决态度
+
+**但凡有问题没有解决，一定是我搞错了**
+- 不要轻易得出"这是外部服务的问题"的结论
+- 必须继续找原因，直到最终修正
+- 体现 Ultrawork 精神:���不放弃,持续推进
+
+### 6. 问题解决流程
+
+遇到问题时的检查顺序：
+1. `.kiro/specs/` 中相关功能的文档
+2. `.kiro/steering/` 中的规则
+3. 项目根目录下的分析文档
+
+### 6. 上下文管控原则
+
+**必须主动管控上下文，避免 session token 耗尽**
+
+**管控时机**：
+- 每完成一组任务后：精简已完成任务的详细内容
+- 每完成一个阶段后：更新 CURRENT_CONTEXT.md
+- Token 使用率 > 50% 时：立即精简
+- 阶段切换时：更新 CURRENT_CONTEXT.md 聚焦新阶段
+
+**精简规则**：
+- Spec 文档：保留任务标题和状态，删除详细实现步骤
+- CURRENT_CONTEXT.md：只保留当前任务核心信息，删除历史详细数据
+
+### 7. Spec 完成与 Steering 更新原则
+
+**每完成一个 Spec，开始新 Spec 前，必须评估是否需要更新 Steering**
+- 通用经验教训 → 更新 CORE_PRINCIPLES
+- 当前 Spec 场景 → 更新 CURRENT_CONTEXT
+
+### 8. 文档精简原则
+
+**Spec 文档精简**：
+- 已完成任务：保留标题和状态，删除详细实现
+- 历史测试结果：保留结论，删除详细日志
+- 文档 > 1000 行：立即拆分为多个文件
+
+**Steering 文档精简**：
+- CURRENT_CONTEXT.md 只保留当前 Spec 核心信息
+- 历史数据归档到 Spec 目录
+- Session 启动后 token 使用率 > 50%：立即精简
+
+---
+
+**版本**: v5.0  
+**更新**: 2026-01-22  
+**说明**: 适用于所有 Spec 的稳定核心原则

package/template/.kiro/steering/CURRENT_CONTEXT.md

@@ -0,0 +1,85 @@
+# 当前场景规则（可变）
+
+> **重要**: 这些规则针对当前 Spec 场景优化，每个新 Spec 开始前应该更新。
+> 基准规则请参考 `CORE_PRINCIPLES.md`，环境配置请参考 `ENVIRONMENT.md`
+
+---
+
+## 🎯 当前状态
+
+**状态**: 🆕 待开始  
+**Spec**: 无  
+**项目**: 简化测试项目  
+**最后更新**: 2026-01-22
+
+---
+
+## 📝 当前 Spec 信息
+
+**当前无活跃 Spec**
+
+请在开始新 Spec 前更新此文档：
+1. 设置当前 Spec 名称和目标
+2. 更简化测试项目信息
+3. 记录当前阶段和进展
+4. 清理历史 Spec 的详细内容
+
+---
+
+## 🔧 Ultrawork 精神已集成
+
+**可用工具**:
+- ✅ `ultrawork_enhancer.py` - 三阶段质量增强工具
+- ✅ `ultrawork.bat` - 便捷批处理脚本
+- ✅ 专业级质量评估体系 (0-10 评分)
+
+**使用方法**:
+```bash
+# 增强 Requirements
+.\ultrawork.bat spec-name requirements
+
+# 增强 Design  
+.\ultrawork.bat spec-name design
+
+# 检查 Tasks
+.\ultrawork.bat spec-name tasks
+
+# 全阶段增强
+.\ultrawork.bat spec-name all
+```
+
+**参考文档**:
+- `.kiro/README.md` - Kiro 系统说明
+- `README.md` - 项目使用指南
+- `ultrawork.bat` - 便捷脚本
+
+---
+
+## 💡 提示
+
+### 开始新 Spec 前的检查清单
+
+- [ ] 确认 Spec 已创建（requirements.md, design.md）
+- [ ] 更新本文档为新 Spec 的场景信息
+- [ ] 移除上一个 Spec 的详细内容
+- [ ] 只保留当前 Spec 的核心信息
+- [ ] 检查 token 使用率
+
+### 内容精简原则
+
+**每完成一个 Spec**:
+- 立即精简历史详细内容
+- 只保留核心经验教训
+- 为新 Spec 腾出空间
+
+**Token 管控**:
+- Token 使用率 > 50% 时,立即精简本文档
+- 删除已完成阶段的详细配置和命令
+- 保留关键经验教训 (1-2 行)
+
+---
+
+**版本**: v3.0  
+**创建**: 2026-01-22  
+**项目**: 通用 Kiro AI-OS 模板  
+**说明**: 已清理项目特定内容，可复制到简化测试项目使用

package/template/.kiro/steering/ENVIRONMENT.md

@@ -0,0 +1,115 @@
+# 项目环境配置（模板）
+
+> **重要**: 这是项目的环境配置模板，复制到新项目时请根据实际情况修改。
+
+---
+
+## 📋 项目基本信息
+
+- **项目名称**: 测试项目
+- **项目类型**: Kiro Spec 驱动开发项目
+- **核心技术**: Kiro Spec + Ultrawork 精神增强
+- **开发语言**: [根据项目调整]
+
+---
+
+## 🖥️ 开发环境
+
+### 本地环境
+- **操作系统**: Windows (cmd shell)
+- **Python**: 3.8+ (用于 Ultrawork 工具)
+- **Kiro IDE**: 最新版本
+
+### 核心组件
+- **Spec 系统**: `.kiro/specs/` - Spec 驱动开发的核心
+- **Steering 系统**: `.kiro/steering/` - AI 行为规则和上下文管理
+- **工具系统**: `.kiro/tools/` - Ultrawork 增强工具
+
+---
+
+## 🔧 配置文件
+
+**核心配置**:
+- `CORE_PRINCIPLES.md` - 基准开发规则(包含 Ultrawork 原则)
+- `ENVIRONMENT.md` - 环境配置(本文件)
+- `CURRENT_CONTEXT.md` - 当前 Spec 场景(每个 Spec 更新)
+- `RULES_GUIDE.md` - 规则索引
+
+**Spec 结构**:
+- `requirements.md` - 需求文档
+- `design.md` - 设计文档
+- `tasks.md` - 任务列表
+
+---
+
+## 🌐 关键目录
+
+- `.kiro/specs/` - 所有 Spec 的存储目录
+- `.kiro/steering/` - AI 行为规则和上下文
+- `.kiro/tools/` - Ultrawork 增强工具
+- `docs/` - 项目文档
+
+---
+
+## 🔐 AI 权限
+
+**授权范围**:
+- ✅ 查看和修改 Spec 文档
+- ✅ 创建和修改 Steering 规则
+- ✅ 使用 Ultrawork 工具增强质量
+- ✅ 执行 Python 脚本(工具层)
+- ❌ 不能修改核心原则(CORE_PRINCIPLES.md)未经用户同意
+
+**操作限制**:
+- 修改 CORE_PRINCIPLES.md 前必须征得用户同意
+- 创建新工具前应先在 Spec 中设计
+- 保持"有节制的 AI 权限"原则
+
+---
+
+## 📦 项目结构
+
+```
+project-root/
+├── .kiro/                      # Kiro 核心目录
+│   ├── specs/                  # Spec 存储
+│   │   └── SPEC_WORKFLOW_GUIDE.md
+│   ├── steering/               # AI 行为规则
+│   │   ├── CORE_PRINCIPLES.md
+│   │   ├── ENVIRONMENT.md (本文件)
+│   │   ├── CURRENT_CONTEXT.md
+│   │   └── RULES_GUIDE.md
+│   ├── tools/                  # Ultrawork 工具
+│   │   └── ultrawork_enhancer.py
+│   ├── ultrawork-application-guide.md
+│   ├── ultrawork-integration-summary.md
+│   └── sisyphus-deep-dive.md
+├── docs/                       # 项目文档
+├── ultrawork.bat              # Ultrawork 便捷脚本
+└── README.md                   # 项目说明
+```
+
+---
+
+## 🔥 Ultrawork 功能
+
+**已集成 Sisyphus 的"不懈努力"精神**:
+- 专业级质量评估体系 (0-10 评分)
+- Requirements/Design/Tasks 三阶段增强
+- 自动改进识别和应用
+- 便捷的批处理脚本
+
+**使用方法**:
+```bash
+.\ultrawork.bat spec-name requirements  # 增强需求文档
+.\ultrawork.bat spec-name design       # 增强设计文档
+.\ultrawork.bat spec-name tasks        # 检查任务完成
+.\ultrawork.bat spec-name all          # 全阶段增强
+```
+
+---
+
+**版本**: v4.0  
+**更新**: 2026-01-22  
+**项目**: 通用 Kiro Spec 项目模板  
+**说明**: 已清理项目特定内容，集成 Ultrawork 精神，可复制使用

package/template/.kiro/steering/RULES_GUIDE.md

@@ -0,0 +1,46 @@
+# Steering 规则索引
+
+> **快速参考**: 各文件职责和快速链接
+
+---
+
+## 📚 文件列表
+
+| 文件 | 职责 | 更新频率 |
+|------|------|---------|
+| **CORE_PRINCIPLES.md** | 核心开发规范 | 很少 |
+| **ENVIRONMENT.md** | 环境配置 | 很少 |
+| **CURRENT_CONTEXT.md** | 当前 Spec 场景 | 每个 Spec ⚠️ |
+
+---
+
+## 🔗 快速链接
+
+- **当前场景**: `CURRENT_CONTEXT.md` - 当前正在推进的 Spec
+- **开发规范**: `CORE_PRINCIPLES.md` - 适用于所有 Spec 的规范
+- **环境配置**: `ENVIRONMENT.md` - 项目环境信息
+- **Spec 工作流**: `../ specs/SPEC_WORKFLOW_GUIDE.md` - Spec 创建和执行流程
+- **体系说明**: `../README.md` - 新项目引导文档
+
+---
+
+## ⚠️ 重要提示
+
+### CURRENT_CONTEXT.md 管控
+
+- **每个新 Spec 开始前**：更新为新 Spec 的场景
+- **Spec 推进中**：及时精简已完成内容
+- **Spec 完成后**：清空，准备下一个 Spec
+- **Token 消耗 > 50% 时**：立即精简
+
+### 精简策略
+
+- ❌ 删除：已完成阶段的详细配置、命令、表格
+- ❌ 删除：历史测试数据和详细流程
+- ✅ 保留：当前阶段的核心信息
+- ✅ 保留：关键经验教训（1-2 行）
+
+---
+
+**版本**: v2.0  
+**更新**: 2025-01-22