SuperAPI AI 工具集

sdlc-create-intent

编程与开发

查看项目

更新于 10-31 16:16

技能介绍

用途

该技能处于 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;若后续结果或范围发生变化,须先修订该工件,再让下游工作依赖它。适当时应请求人工评审。