Communitygithub.com

leonhoffmann86/team-sprint

🏃 Sprint — 将每个待办项转化为完整的小型冲刺:通过 git-hook 智能体链、隔离工作树、确定性门控与失败封闭审查,为 Claude Code 实现自主 计划→实施→审查 流程。

team-sprint 是什么?

该技能将模糊的待办事项转化为经过严格审查的结构化任务,并写入 `TODO.md`,然后通过一个自主智能体链推动该任务经历完整的计划→实施→代码审查周期。它利用 Git 挂钩、隔离的工作树和确定性门控,确保代码更改在安全条件下交付。该技能适用于所有支持 Git 钩子和 Claude Code 的仓库,通过“风险等级”和“失败封闭审查”设计来降低自动化开发的风险——高风险的更改会被自动标记,交由人工处理。其工作原理是:首先,它会读取项目的“宪法”文件(如 `sprint.conf`、`AGENTS.md`、`CLAUDE.md`)以理解约定的工作方式。然后,通过代码图谱(`codegraph`)或备选的 Grep/Glob 搜索,将想法与实际代码结构相联系,定位受影响的符号和文件。接着,它会质疑该想法,判断其是问题还是任务,明确真正的范围和风险等级,并识别需要用户决策的关键产品/UX/策略问题。最后,为一个最小的、有价值的更改起草一个包含清晰任务、风险等级、完成标准(如特定的测试通过)和文件/函数提示的单一结构化待办项,在用户批准后写入 `TODO.md`,并询问用户是否希望立即启动由 git 钩子触发的自动实施链。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

你将把一个粗糙的想法转化为 TODO.md 中一个结构完善的任务。这个粗糙的想法是:

$ARGUMENTS

这是一个精炼工作流,而不是实施。不要编写代码。 在任务清晰且用户批准之前,不要写入 TODO.md。按以下步骤工作:

1. 阅读宪法

找到项目的宪法文件并阅读它们——遵循它们的约定,特别是风险等级以及任何自主智能体/待办项生命周期规则。

  • 如果 sprint.conf 存在,按顺序读取 SPRINT_CONSTITUTION_FILES 中列出的文件。
  • 否则,读取存在的 AGENTS.md、CLAUDE.md(以及它们引用的任何项目特定指南,例如前端的 CLAUDE.md)。
  • 如果存在,浏览 .githooks/README.md,以便正确描述下游影响。 如果这些都不存在,告诉用户仓库尚未引导,并提供 /sprint:bootstrap。

2. 将想法植根于真实代码(不要猜测)

找到该想法实际涉及的符号/文件及其影响范围:

  • 代码图谱(首选,如果可用):mcp__codegraph__* 工具(codegraph_search、…_callers、…_callees、…_impact、…_context),或 CLI(codegraph context "<the idea>"、codegraph callers <symbol>、codegraph impact <symbol>);如果索引看起来过时,先运行 codegraph sync .。
  • 备选方案(没有代码图谱):使用 Grep/Glob 查找相关的符号及其调用方。 读取实际重要的几个文件。命名具体的函数/文件以及更改发生的位置。

3. 质疑它(本技能的核心)

根据代码已有的功能对想法提出质疑。揭示:

  • 这是一个问题还是一个任务?如果它实际上是一个问题(“……还是我漏掉了什么?”),首先从代码中回答它——现有的逻辑可能已经覆盖了它的一部分。
  • 真正的范围以及交付价值的最小更改。
  • 风险等级(根据宪法 / AGENTS.md)。如果是高风险,请明确说明——它不会被自动实施;链将把它移交给人工处理。
  • 哪些决定应由用户做出,而不是你做出(产品/UX/策略选择)。 使用 AskUserQuestion 向用户提出那少数几个决定。不要凭空捏造真正产品决策的答案;使用代码库中的证据纠正错误的假设。

4. 起草一个结构化的条目(四个要素)

起草一个包含以下内容的草稿:

  1. 一个明确的命令式任务(而非问题),
  2. 风险等级,
  3. 一个具体的完成标准(哪个目标测试必须通过 / 哪个行为是可验证的),
  4. 来自步骤 2 的文件/函数提示。 保持最小的价值更改。展示草稿并反复修改,直到用户满意。

5. 将其写入 TODO.md,然后移交

  • 将批准的项目作为 - [ ] 条目添加到 TODO.md 顶部附近。
  • 询问是否将其设为唯一的活跃项——如果是,则将其他当前活跃的项移动到 <!-- … --> 块内(或根据跳过约定放在 ## 🚧 Deferred 下),以便链只处理这一个。
  • 不要自动提交。 告诉用户:提交 TODO.md 将启动计划→实施→审查链(实施将落地到 impl 分支,不会自动合并)。如果用户希望流程现在开始,询问是否提交。

保持对话紧凑:首先锚定代码,只询问真正重要的决策,然后编写。

相关技能