用途
Sprint Forge 是一个自适应冲刺工作流技能，面向迭代式项目执行。它不同于预先一次性生成所有冲刺的刚性规划器，其核心思路是：先分析、再规划，逐个生成冲刺，并让计划随执行结果不断演进。该技能与语言、框架、项目类型无关，不预设 Flutter、React、Dart 或任何特定技术，具体结构由分析结果决定。
主要能力
- 先分析后规划：在确定计划前对项目或问题进行深度探索。
- 逐个生成冲刺：每个冲刺都从上一次的回顾、建议和累积债务中获取输入，确保计划贴合现实。
- 正式追踪债务：维护一张跨冲刺继承的累积技术债务表，条目不会丢失，只有状态会变化。
- 自适应路线图：路线图是活文档，若执行中发现某个计划中的冲刺不再合理，可更新路线图。
- 上下文持久化：在 INIT 之后以及每个冲刺执行之后更新重新进入提示词，使任意会话中的任意智能体都能恢复完整项目上下文并无缝继续。
关键规则
- 逐个冲刺：冲刺一次只生成一个，绝不预先全部生成。
- 建议阶段而非刚性约束：路线图为每个冲刺定义建议阶段，执行中若出现新发现，必须加入涌现阶段。
- 回顾是正式输入：第 N-1 个冲刺的回顾与建议是第 N 个冲刺的正式输入，每条建议要么成为下一冲刺的任务，要么在处置表中说明推迟理由。
- 债务永不消失：累积技术债务表逐冲刺继承，条目仅在明确解决时才关闭，绝不删除，只改变状态。
- 自适应：路线图服务于执行，而非相反。
- 语言无关：适用于任意语言、框架或项目类型。
- 上下文持久化：INIT 后及每个冲刺执行后更新重新进入提示词。
使用方式
该技能采用模块化资产架构，详细工作流、辅助工具和模板位于 assets/ 目录：assets/modes/ 存放 INIT、SPRINT、STATUS 模式工作流；assets/helpers/ 存放分析指南、债务追踪器、冲刺生成器、重新进入生成器；assets/templates/ 存放路线图、冲刺、项目 README 和重新进入提示词模板。完整目录文档见 assets/README.md。
配置解析：{output_sprint_forge_dir} 是 sprint-forge 存储所有项目文档的目录。若用户消息包含文件路径，则从中提取该目录；INIT（首次）时询问用户保存位置，并将所选路径存入 README.md 和 RE-ENTRY-PROMPTS.md，这两者是唯一事实来源；SPRINT/STATUS 无重新进入提示词时，通过扫描 {cwd} 下的 .agents/sprint-forge/ 自动发现，或直接询问用户。不使用 AGENTS.md，也不使用品牌化区块。
所有生成的 markdown 文档都包含遵循 Obsidian markdown 标准的 YAML frontmatter，其中 agents 字段记录生成或修改文档的 AI 模型；{agent_model} 从当前会话所用模型 ID 解析（如 "claude-opus-4-6"、"gpt-4o"、"codex"、"grok"）；修改已有文档时，若当前模型不在 agents 数组中则追加。
模式检测：INIT 对应“analyze”“audit”“start project”“create roadmap”等信号，用于分析项目、生成发现、创建路线图、搭建 vault 结构并生成重新进入提示词；SPRINT 对应“generate sprint”“next sprint”“execute sprint”等信号，用于基于路线图、上一冲刺和债务生成下一个冲刺，并可选执行；STATUS 对应“project status”“progress”“technical debt”等信号，用于报告已完成冲刺、累积债务、指标和下一冲刺预览。若意图不明确，会询问用户要分析项目（INIT）、生成/执行下一冲刺（SPRINT）还是查看项目状态（STATUS）。
资产按模式加载：检测到模式后只读取该模式列出的资产，不读取其他模式的资产，以免浪费上下文 token。INIT 读取 INIT.md、analysis-guide.md、reentry-generator.md；SPRINT 读取 SPRINT.md、sprint-generator.md、debt-tracker.md、reentry-generator.md；STATUS 读取 STATUS.md、debt-tracker.md。模板按需加载，即每个工作流步骤引用时才加载，而非预先加载。
快速开始：INIT 模式可输入“Analyze this project and create a roadmap for the refactoring work.”，将探索代码库、生成发现、创建自适应路线图、搭建输出目录并生成重新进入提示词；SPRINT 模式可输入“Generate the next sprint.”或“Generate and execute the next sprint.”，将读取路线图和上一冲刺、构建处置表、生成阶段，并可选逐任务执行；STATUS 模式可输入“Show me the project status and technical debt.”，将读取所有冲刺、计算指标、显示进度和累积债务。
适用场景
适用于需要迭代推进、且计划需随执行结果调整的任意类型项目，包括重构工作等。可与 code-analyzer 技能集成：在 INIT 中作为前置步骤，其报告输入 Sprint Forge 的发现，为路线图提供结构化技术输入。
限制
- 模式边界：各模式能力固定——INIT 不能执行代码，SPRINT 不能创建路线图，STATUS 不能修改文件。
- 一次一个冲刺：按设计无法提前生成多个冲刺。
- 需先分析：SPRINT 模式预期已运行 INIT，需要路线图和发现。
- 手动执行：冲刺任务由智能体执行，而非自动化 CI/CD。
- 上下文窗口：冲刺较多（>5）的项目建议每个冲刺使用独立会话，重新进入提示词确保连续性。
- 无自动验证：无法验证路线图是否与代码库现实一致，依赖 INIT 期间的充分分析。
- 外部阻塞：无法解决对外部团队的依赖，会将其记录为阻塞任务并继续。
- 债务解决：债务条目需明确操作才能关闭，不会自动解决。