你将把一个粗糙的想法转化为 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. 起草一个结构化的条目(四个要素)
起草一个包含以下内容的草稿:
- 一个明确的命令式任务(而非问题),
- 风险等级,
- 一个具体的完成标准(哪个目标测试必须通过 / 哪个行为是可验证的),
- 来自步骤 2 的文件/函数提示。 保持最小的价值更改。展示草稿并反复修改,直到用户满意。
5. 将其写入 TODO.md,然后移交
- 将批准的项目作为
- [ ]条目添加到TODO.md顶部附近。 - 询问是否将其设为唯一的活跃项——如果是,则将其他当前活跃的项移动到
<!-- … -->块内(或根据跳过约定放在## 🚧 Deferred下),以便链只处理这一个。 - 不要自动提交。 告诉用户:提交
TODO.md将启动计划→实施→审查链(实施将落地到 impl 分支,不会自动合并)。如果用户希望流程现在开始,询问是否提交。
保持对话紧凑:首先锚定代码,只询问真正重要的决策,然后编写。