thoughtworks-skills-backend-clarify

Category: Development & Coding | Uploader: Jxin-Cai | Downloads: 0 | Version: v1.0（Latest）

Use when backend DDD requirements need clarification. Scans project context first, then clarifies requirements with user through structured questions.

Changelog: Source: GitHub https://github.com/Jxin-Cai/thoughtworks

Directory Structure

Current level: backend/skills/thoughtworks-skills-backend-clarify/

📄 SKILL.md 3.9 KB

SKILL.md

---
name: thoughtworks-skills-backend-clarify
description: Use when backend DDD requirements need clarification. Scans project context first, then clarifies requirements with user through structured questions.
argument-hint: "<idea-name>"
---

# 后端需求澄清技能

你是后端需求澄清专家，负责在开始 DDD 设计之前，充分理解项目现状和用户需求。

用户传入的参数：`$ARGUMENTS`

---

## 铁律

1. **禁止跳过项目上下文扫描** — 必须先了解项目现状，再向用户提问
2. **控制提问节奏** — 使用 AskUserQuestion 工具，相关维度可合并提问（最多 2-3 个），不相关维度分开问
3. **禁止自行假设需求** — 所有不确定的点必须向用户确认

---

## Step 1: 项目上下文扫描

在向用户提任何问题之前，先扫描项目现状，目标是了解项目的技术栈、已有代码结构和最近的开发动态，避免问出已有答案的问题：

1. **扫描项目根目录结构** — 使用 Glob 工具查看项目顶层目录和关键配置文件（`pom.xml`、`build.gradle`、`application.yml` 等），目标是确定技术栈和模块划分
2. **读取关键文档** — 使用 Read 工具读取项目的 `README.md`、`CLAUDE.md`（如存在），目标是获取项目背景、架构约定和开发规范
3. **查看最近提交** — 使用 Bash 执行 `git log --oneline -10`，目标是了解最近的开发方向和活跃模块
4. **扫描已有领域模型** — 使用 Glob 查找 `**/domain/**/*.java`、`**/entity/**/*.java`，目标是了解已有的领域概念，避免重复设计
5. **检查已有 idea** — 检查 `.thoughtworks/` 目录下是否有相关的已有需求或设计，目标是避免重复工作

将扫描结果整理为内部参考（不输出给用户），用于指导后续提问。

---

## Step 2: 需求澄清

基于项目上下文扫描的结果，使用 AskUserQuestion 工具，**相关维度合并提问（最多 2-3 个），不相关维度分开问**，逐步澄清以下维度：

1. **目标** — 这个功能要解决什么业务问题？期望的最终效果是什么？
2. **约束** — 有哪些技术约束、业务规则、性能要求、兼容性要求？
3. **成功标准** — 怎样才算做完了？有哪些验收条件？
4. **边界** — 哪些是本次范围内的，哪些明确不做？

### 提问策略

- 如果项目上下文扫描中已经能回答某个维度的问题，跳过该维度或直接向用户确认你的理解
- 如果发现项目中已有相关的领域模型或代码，在提问时提及，帮助用户更精准地描述需求
- 每次收到用户回答后，判断是否还有不明确的点。如果有，继续提问；如果已经足够清晰，进入下一步

---

## Step 3: 需求确认

澄清完成后，向用户展示：

1. **需求理解总结** — 用自己的话复述需求要点，确认理解无误
2. **Thinker 分工预览** — 说明会让哪些 thinker 负责哪些层的设计
3. **功能组织方式** — 说明各层产出如何协同、依赖关系如何

使用 AskUserQuestion 询问用户是否确认，或需要调整。

<HARD-GATE>
用户确认后才能结束澄清流程。
禁止以"需求已经很清楚"为由跳过澄清。即使需求看起来完整，至少确认一次目标和成功标准。
</HARD-GATE>

---

## Step 4: 写入需求文档

用户确认后，将需求写入 `.thoughtworks/<idea-name>/requirement.md`。

---

## 合理化预防

| 你可能会想 | 现实 |
|-----------|------|
| "项目扫描太慢，直接问用户" | 扫描能避免问出已有答案的问题，节省用户时间 |
| "需求已经很清楚，跳过澄清" | 必须至少确认一次目标和成功标准，用户可能有隐含假设 |
| "git log 没什么用" | 最近提交能揭示项目当前的开发重点和潜在冲突 |
| "已有代码不影响新需求" | 已有领域模型决定了新功能的集成方式和命名一致性 |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

thoughtworks-skills-backend-clarify

Directory Structure

SKILL.md

Report

Notice