SuperAPI AI 工具集

sprint-forge

编程与开发

查看项目

更新于 10-16 05:29

技能介绍

用途

Kyro(sprint-forge)是一个自适应冲刺工作流技能,面向迭代式项目执行。它不预先一次性生成所有冲刺,而是先分析、再逐个生成冲刺,让计划随执行中暴露的真实情况不断演进。该技能适用于任何项目类型、语言或框架。

主要能力

  • 先分析后规划:在承诺计划前对项目或问题进行深度探索。
  • 逐个生成冲刺:每个冲刺都从上一次冲刺的回顾、建议和累积债务中获取输入。
  • 正式跟踪债务:累积技术债务表跨冲刺继承,条目永不丢失,只有显式解决才会关闭。
  • 自适应路线图:路线图是活文档,执行揭示计划不再合理时可更新。
  • 上下文持久化:重入提示允许新智能体或新会话恢复完整项目上下文并无缝继续。
  • 语言无关:不假设 Flutter、React、Dart 或任何特定技术,由分析决定结构。

三种模式

  • INIT:分析代码库或项目、生成发现、创建路线图、搭建文档目录、生成重入提示。
  • SPRINT:从路线图、上一冲刺和债务生成下一个冲刺,可选执行任务。
  • STATUS:报告已完成冲刺、累积债务、指标和下一冲刺预览。

模式检测依据用户信号,例如 INIT 对应“analyze”“audit”“start project”“create roadmap”,SPRINT 对应“generate sprint”“next sprint”“execute sprint”,STATUS 对应“project status”“progress”“technical debt”。意图不明确时会询问用户选择哪种模式。

使用方式

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.”

配置解析:{output_kyro_dir} 是 kyro 存储所有项目文档的目录。若用户消息包含文件路径,则从中提取;INIT 首次运行时询问用户保存位置,并存入 README.md 和 RE-ENTRY-PROMPTS.md;SPRINT/STATUS 无重入提示时,扫描 {cwd} 下的 .agents/sprint-forge/ 或直接询问用户。

资产按模式加载: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。模板按需加载。

关键规则

  1. 冲刺逐个生成,绝不预生成全部冲刺。
  2. 路线图定义建议阶段,执行中出现的新发现必须加入涌现阶段。
  3. 上一冲刺的回顾和建议是下一冲刺的正式输入,每条建议要么成为任务,要么在处置表中说明推迟理由。
  4. 累积技术债务表跨冲刺继承,条目永不删除,只改变状态。
  5. 路线图是活文档,计划服务于执行。
  6. 语言无关。
  7. INIT 后及每个冲刺执行后更新重入提示,实现上下文持久化。

工作流组件

Kyro v2.0 以一个编排智能体运行,包含内置检查点和命令。协议包括:分析协议(INIT 模式只读代码库分析)、审查清单(SPRINT 模式任务关闭前质量验证)、调试协议(SPRINT 模式任务失败时根因调查)、全周期协调(/kyro-workflow:forge 命令管理门控与冲刺生命周期)。

命令:/kyro-workflow:forge 对应完整周期 INIT → SPRINT → Review → Close 并带验证门控;/kyro-workflow:status 对应 STATUS 模式;/kyro-workflow:wrap-up 对应会话结束收尾仪式,含质量检查与上下文交接。

内置检查点包括 session_start(加载 .agents/sprint-forge/rules.md 中的学习规则)、post_edit_scan(代码编辑后检查调试残留)、task_complete(运行审查清单)、drift_check(启用时检测范围漂移)、rule_check(任务执行前检查相关学习规则)。

与其他技能的集成

code-analyzer 可在 INIT 中作为前置步骤,其报告汇入 Kyro 发现,为路线图提供结构化技术输入。

适用场景

适合需要迭代推进、持续跟踪技术债务、并希望跨会话保持上下文的项目开发与重构工作。

限制

  • 模式边界:INIT 不能执行代码,SPRINT 不能创建路线图,STATUS 不能修改文件。
  • 一次一个冲刺:设计上不能提前生成多个冲刺。
  • 需要先分析:SPRINT 模式期望已运行 INIT,需要路线图和发现。
  • 手动执行:冲刺任务由智能体执行,不是自动化 CI/CD。
  • 上下文窗口:冲刺较多(>5)的项目建议每个冲刺使用独立会话,重入提示确保连续性。
  • 无自动验证:无法验证路线图是否与代码库现实一致,依赖 INIT 期间的充分分析。
  • 外部阻塞:无法解决对外部团队的依赖,会记录为阻塞任务并继续。
  • 债务解决:债务条目需要显式操作才能关闭,不会自动解决。