关于 sdlc-create-intent
这是一项将非正式需求整理为 SDLC 意图文档的工作流技能,适用于启动仓库任务的团队。它侧重明确目标、范围边界、约束和未决问题,不进入规格编写或实现阶段。
主要功能
- 01生成 intent.md 文档
- 02梳理问题与预期结果
- 03记录范围和非目标
- 04整理约束与待解决问题
- 05暂不编写规格或代码
适用场景
- 01根据请求启动 SDLC 工作项
- 02明确缺陷影响及预期行为
- 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