mcpField
S
sdlc-create-intent

sdlc-create-intent

github.com/wesleycamargo其他039 次安装3 周前更新
代码仓库

关于 sdlc-create-intent

这是一项将非正式需求整理为 SDLC 意图文档的工作流技能,适用于启动仓库任务的团队。它侧重明确目标、范围边界、约束和未决问题,不进入规格编写或实现阶段。

主要功能

  1. 01生成 intent.md 文档
  2. 02梳理问题与预期结果
  3. 03记录范围和非目标
  4. 04整理约束与待解决问题
  5. 05暂不编写规格或代码

适用场景

  1. 01根据请求启动 SDLC 工作项
  2. 02明确缺陷影响及预期行为
  3. 03规划前记录重构需保持的行为

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/wesleycamargo/devcontainer-template --skill sdlc-create-intent

安装后在 Claude Code 中输入/sdlc-create-intent确认已加载。

详细介绍

创建意图

阶段定位

这是 SDLC 的第一个阶段。根据非正式请求,创建 sdlc//intent.md。不要创建 spec.md、plan.md、任务或代码。

输入和输出

  • 必需输入:请求。如果仓库说明和相关惯例可能影响范围或约束,请先检查。
  • 输出:在简短的全小写 kebab-case 工作项目录中创建一份自包含的意图文档。如果提供了外部工作项 ID,则将其纳入;绝不要求必须提供。

职责

找出根本问题或机会、期望结果、纳入范围、不在目标内的事项、受影响的用户、系统或能力、重要约束,以及适用时可衡量的成功指标。区分请求的结果与建议的解决方案。记录重要的模糊之处、假设和待解问题,不要擅自做出业务决策或扩大范围。

对于缺陷,描述实际行为、预期行为和影响。对于技术债,描述当前风险或成本。对于功能,描述其能力以及由此实现的结果。对于重构,说明重构的必要性,以及必须保持不变的行为。

仅使用相关章节,通常包括:

`markdown

意图:<标题>

问题

期望结果

范围

不在目标内

约束

成功标准

待解问题

`

只有当答案会实质性改变意图时才提问。通过 Agent 的交互式提问工具提问(Claude Code:AskUserQuestion),将相关问题合并在一次调用中,每个问题提供 2-4 个建议选项,并将推荐选项置于首位且标注“(推荐)”,让用户通过按钮作答;如果没有此类工具,则仅使用纯文本。当假设并非关键且不会阻碍进展时,记录合理假设,而不是要求用户确认。除非技术或架构已被确认为约束,否则不要自行选定。

交接

适当时请求人工审查。意图获批后,将工作项路径交接给 sdlc-create-spec。如果之后要更改结果或范围,必须先修订本文档,再开展后续工作。

评论

支持 Markdown