用途
该技能处于 SDLC 的第一阶段。给定一个非正式的软件请求,它创建 sdlc//intent.md 意图工件,不创建 spec.md、plan.md、任务或代码,目的是在进入规格或设计之前先把问题与范围界定清楚。
主要能力
- 识别底层问题或机会、期望结果、包含范围、非目标、受影响的用户/系统/能力、实质性约束,以及在适当情况下可衡量的成功指标。
- 将「所请求的结果」与「建议的解决方案」区分开。
- 记录实质性歧义、假设和待解决问题,但不编造业务决策,也不扩大范围。
- 按请求类型侧重不同信息:缺陷——描述实际行为、期望行为与影响;技术债——描述当前风险或成本;功能——描述能力及其带来的结果;重构——说明必要性及必须保持不变的行为。
- 当外部工作项 ID 提供时予以记录,但从不强制要求。
使用方式
必需输入为请求本身;当仓库说明和相关约定可能影响范围或约束时,应予以检查。输出为一个自包含的意图工件,放在短小写 kebab-case 命名的工作项目录中。工件通常使用以下相关章节(仅用相关部分):
Intent:
Problem
Desired Outcome
Scope
Non-Goals
Constraints
Success Criteria
Open Questions
提问原则:仅当答案会实质改变意图时才提问;通过代理的交互式提问工具(如 Claude Code 的 AskUserQuestion)提问,将相关问题合并在一次调用中,每个问题提供 2-4 个建议选项,推荐项放在首位并标注“(Recommended)”,以便用户按键回答;仅当不存在此类工具时才使用纯文本。非关键的合理假设直接记录,不阻塞流程。除非是已确认的约束,否则不选择技术或架构。
适用场景
适合在收到新的软件请求、缺陷、改进、技术债或重构诉求后,先沉淀出受范围约束的意图文档,再进入规格与设计阶段。
限制
本阶段不产出规格、计划、任务或代码;不擅自作出业务决策或扩大范围。意图获批准后应连同工作项路径移交至 sdlc-create-spec;若后续结果或范围发生变化,须先修订该工件,再让下游工作依赖它。适当时应请求人工评审。