npm - kiro-spec-engine - Versions diffs - 1.2.3 → 1.4.0 - Mend

kiro-spec-engine 1.2.3 → 1.4.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 (78) hide show

package/CHANGELOG.md +135 -0
package/README.md +239 -213
package/README.zh.md +0 -330
package/bin/kiro-spec-engine.js +62 -0
package/docs/README.md +223 -0
package/docs/agent-hooks-analysis.md +815 -0
package/docs/command-reference.md +252 -0
package/docs/cross-tool-guide.md +554 -0
package/docs/examples/add-export-command/design.md +194 -0
package/docs/examples/add-export-command/requirements.md +110 -0
package/docs/examples/add-export-command/tasks.md +88 -0
package/docs/examples/add-rest-api/design.md +855 -0
package/docs/examples/add-rest-api/requirements.md +323 -0
package/docs/examples/add-rest-api/tasks.md +355 -0
package/docs/examples/add-user-dashboard/design.md +192 -0
package/docs/examples/add-user-dashboard/requirements.md +143 -0
package/docs/examples/add-user-dashboard/tasks.md +91 -0
package/docs/faq.md +696 -0
package/docs/integration-modes.md +525 -0
package/docs/integration-philosophy.md +313 -0
package/docs/manual-workflows-guide.md +417 -0
package/docs/quick-start-with-ai-tools.md +374 -0
package/docs/quick-start.md +711 -0
package/docs/spec-workflow.md +453 -0
package/docs/steering-strategy-guide.md +196 -0
package/docs/tools/claude-guide.md +653 -0
package/docs/tools/cursor-guide.md +705 -0
package/docs/tools/generic-guide.md +445 -0
package/docs/tools/kiro-guide.md +308 -0
package/docs/tools/vscode-guide.md +444 -0
package/docs/tools/windsurf-guide.md +390 -0
package/docs/troubleshooting.md +795 -0
package/docs/zh/README.md +275 -0
package/docs/zh/quick-start.md +711 -0
package/docs/zh/tools/claude-guide.md +348 -0
package/docs/zh/tools/cursor-guide.md +280 -0
package/docs/zh/tools/generic-guide.md +498 -0
package/docs/zh/tools/kiro-guide.md +342 -0
package/docs/zh/tools/vscode-guide.md +448 -0
package/docs/zh/tools/windsurf-guide.md +377 -0
package/lib/adoption/detection-engine.js +14 -4
package/lib/commands/adopt.js +117 -3
package/lib/commands/context.js +99 -0
package/lib/commands/prompt.js +105 -0
package/lib/commands/status.js +225 -0
package/lib/commands/task.js +199 -0
package/lib/commands/watch.js +569 -0
package/lib/commands/workflows.js +240 -0
package/lib/commands/workspace.js +189 -0
package/lib/context/context-exporter.js +378 -0
package/lib/context/prompt-generator.js +482 -0
package/lib/steering/adoption-config.js +164 -0
package/lib/steering/steering-manager.js +289 -0
package/lib/task/task-claimer.js +430 -0
package/lib/utils/tool-detector.js +383 -0
package/lib/watch/action-executor.js +458 -0
package/lib/watch/event-debouncer.js +323 -0
package/lib/watch/execution-logger.js +550 -0
package/lib/watch/file-watcher.js +499 -0
package/lib/watch/presets.js +266 -0
package/lib/watch/watch-manager.js +533 -0
package/lib/workspace/workspace-manager.js +370 -0
package/lib/workspace/workspace-sync.js +356 -0
package/package.json +3 -1
package/template/.kiro/tools/backup_manager.py +295 -0
package/template/.kiro/tools/configuration_manager.py +218 -0
package/template/.kiro/tools/document_evaluator.py +550 -0
package/template/.kiro/tools/enhancement_logger.py +168 -0
package/template/.kiro/tools/error_handler.py +335 -0
package/template/.kiro/tools/improvement_identifier.py +444 -0
package/template/.kiro/tools/modification_applicator.py +737 -0
package/template/.kiro/tools/quality_gate_enforcer.py +207 -0
package/template/.kiro/tools/quality_scorer.py +305 -0
package/template/.kiro/tools/report_generator.py +154 -0
package/template/.kiro/tools/ultrawork_enhancer_refactored.py +0 -0
package/template/.kiro/tools/ultrawork_enhancer_v2.py +463 -0
package/template/.kiro/tools/ultrawork_enhancer_v3.py +606 -0
package/template/.kiro/tools/workflow_quality_gate.py +100 -0

package/docs/zh/README.md ADDED Viewed

@@ -0,0 +1,275 @@
+# kse 文档索引
+> kse (Kiro Spec Engine) 的完整文档 - AI 辅助开发的上下文管理系统
+---
+**版本**: 1.0.0
+**最后更新**: 2026-01-23
+**语言**: 简体中文
+---
+## 📚 文档概述
+本文档集合提供了使用 kse 进行 Spec 驱动开发所需的一切。无论你是初学者还是高级用户，你都会在这里找到所需的指导。
+---
+## 🚀 入门指南
+从这里开始你的 kse 之旅：
+### [快速入门指南](quick-start.md)
+**5 分钟教程** - 从安装到第一个 AI 辅助功能实现
+- 安装 kse
+- 创建你的第一个 Spec
+- 导出上下文
+- 使用 AI 工具实现功能
+### [常见问题 (FAQ)](faq.md)
+**常见问题解答** - 关于 kse 的快速答案
+- kse 是什么？
+- 它如何与 AI 工具配合使用？
+- 我应该使用哪个 AI 工具？
+- 常见误解
+### [故障排除](troubleshooting.md)
+**问题解决** - 常见问题和解决方案
+- 安装问题
+- 采用问题
+- 命令错误
+- 集成问题
+---
+## 📋 核心概念
+深入理解 kse 的工作原理：
+### [Spec 工作流](spec-workflow.md)
+**深入指南** - 理解 Spec 驱动开发
+- 什么是 Spec？
+- Requirements → Design → Tasks 工作流
+- 创建有效 Spec 的最佳实践
+- 示例 Spec 演练
+### [集成模式](integration-modes.md)
+**三种集成方式** - 选择最适合你的模式
+- 原生集成（Kiro、Windsurf）
+- 手动导出（Claude、Cursor、ChatGPT）
+- Watch 模式（所有工具）
+- 每种模式的优缺点
+### [命令参考](command-reference.md)
+**完整命令列表** - 所有 kse 命令及示例
+- 项目设置命令
+- 上下文管理命令
+- 任务管理命令
+- 自动化命令
+---
+## 🔧 工具专用指南
+为你的 AI 工具选择集成指南：
+### IDE 集成
+#### [Cursor 指南](tools/cursor-guide.md)
+**Cursor IDE** - 带 AI 结对编程的 IDE
+- 手动导出模式
+- Composer 集成
+- 最佳实践
+#### [Windsurf 指南](tools/windsurf-guide.md)
+**Windsurf IDE** - 带命令执行的 AI 代理
+- 原生集成
+- Watch 模式
+- 自动化工作流
+#### [Kiro 指南](tools/kiro-guide.md)
+**Kiro IDE** - 专为 Spec 驱动开发设计
+- 完全原生集成
+- 可视化工具
+- 零配置
+#### [VS Code + Copilot 指南](tools/vscode-guide.md)
+**VS Code** - 带 GitHub Copilot
+- 内联注释集成
+- Copilot Chat
+- 代码片段
+### 聊天机器人集成
+#### [Claude 指南](tools/claude-guide.md)
+**Claude Code** - Anthropic 的 AI 助手
+- 对话式开发
+- 长上下文窗口
+- 示例提示
+### 通用集成
+#### [通用 AI 工具指南](tools/generic-guide.md)
+**适用于任何 AI 工具** - 灵活的集成方法
+- 三种集成模式
+- 工具无关工作流
+- 自定义集成
+---
+## 💡 示例和模板
+从真实示例中学习：
+### 完整 Spec 示例
+#### [API 功能示例](examples/add-rest-api/)
+**RESTful API Spec** - 带认证的完整 API
+- 完整的 requirements.md
+- 详细的 design.md
+- 分步 tasks.md
+#### [UI 功能示例](examples/add-user-dashboard/)
+**React 仪表板 Spec** - 前端功能
+- 组件层次结构
+- 状态管理设计
+- UI 实现任务
+#### [CLI 功能示例](examples/add-export-command/)
+**CLI 命令 Spec** - 命令行工具
+- 命令设计
+- 参数处理
+- 测试策略
+---
+## 📖 高级主题
+对于有经验的用户：
+### [采用指南](adoption-guide.md)
+**在现有项目中采用 kse** - 迁移策略
+- 评估你的项目
+- 采用策略
+- 迁移现有文档
+### [升级指南](upgrade-guide.md)
+**版本升级** - 保持 kse 最新
+- 升级过程
+- 版本兼容性
+- 迁移指南
+### [手动工作流](manual-workflows-guide.md)
+**分步工作流** - 详细过程
+- 创建 Spec 工作流
+- 实现工作流
+- 审查工作流
+### [开发者指南](developer-guide.md)
+**贡献和扩展 kse** - 对于贡献者
+- 项目结构
+- 开发设置
+- 贡献指南
+---
+## 🗺️ 学习路径
+### 对于初学者
+1. 从[快速入门指南](quick-start.md)开始
+2. 阅读[Spec 工作流](spec-workflow.md)
+3. 选择你的工具指南：
+   - [Cursor](tools/cursor-guide.md)
+   - [Claude](tools/claude-guide.md)
+   - [Windsurf](tools/windsurf-guide.md)
+   - [VS Code](tools/vscode-guide.md)
+4. 查看[示例](examples/add-rest-api/)
+5. 查阅[FAQ](faq.md)和[故障排除](troubleshooting.md)
+### 对于有经验的用户
+1. 查看[集成模式](integration-modes.md)
+2. 探索[高级主题](#-高级主题)
+3. 阅读[开发者指南](developer-guide.md)
+4. 贡献到项目
+### 对于团队
+1. 阅读[采用指南](adoption-guide.md)
+2. 设置团队约定
+3. 创建共享 Spec 模板
+4. 建立审查流程
+---
+## 🔍 按主题查找
+### 安装和设置
+- [快速入门 - 安装](quick-start.md#步骤-1安装-kse30-秒)
+- [故障排除 - 安装问题](troubleshooting.md)
+- [采用指南](adoption-guide.md)
+### 创建 Spec
+- [快速入门 - 创建 Spec](quick-start.md#步骤-3创建你的第一个-spec2-分钟)
+- [Spec 工作流](spec-workflow.md)
+- [示例 Spec](examples/add-rest-api/)
+### AI 工具集成
+- [集成模式](integration-modes.md)
+- [工具专用指南](#-工具专用指南)
+- [通用指南](tools/generic-guide.md)
+### 任务管理
+- [命令参考 - 任务命令](command-reference.md)
+- [Spec 工作流 - 任务](spec-workflow.md)
+### 自动化
+- [集成模式 - Watch 模式](integration-modes.md)
+- [Windsurf 指南 - Watch 配置](tools/windsurf-guide.md)
+---
+## 📞 获取帮助
+### 文档
+- 📖 从[快速入门指南](quick-start.md)开始
+- 🤔 查看[常见问题](faq.md)
+- 🔧 查阅[故障排除](troubleshooting.md)
+### 社区
+- 💬 [GitHub Discussions](https://github.com/yourusername/kiro-spec-engine/discussions)
+- 🐛 [GitHub Issues](https://github.com/yourusername/kiro-spec-engine/issues)
+- 📧 support@example.com
+---
+## 🤝 贡献
+帮助改进文档：
+- 📝 报告文档问题
+- ✏️ 建议改进
+- 🌍 帮助翻译
+- 📖 分享你的经验
+查看[贡献指南](../CONTRIBUTING.md)了解详情。
+---
+## 📄 许可证
+本文档根据 MIT 许可证授权。查看[LICENSE](../LICENSE)了解详情。
+---
+**准备好开始了吗？** 🚀
+从[快速入门指南](quick-start.md)开始你的 kse 之旅！
+---
+**版本**: 1.0.0
+**最后更新**: 2026-01-23
+**语言**: 简体中文