🐛 fix(vscode): 提示词对齐 ECC 实际命令，需求文档改走 specs 布局
头脑风暴、实施、审查三套提示词引用的 /ecc:plan-prd、grill-me、 /ecc:tdd-workflow、/review 在 ECC 2.2.15 里都不存在，会话拿到的是一 条无效命令。审查提示词里的 /ecc:review-pr 走 gh，对 Gitea 不可用。 改为 ECC 实际链路：/ecc:grilling 讨论、/ecc:spec 出设计文档、 /ecc:plan 出计划、/ecc:tdd 实施，审查直接派 ecc:code-reviewer 等子代 理审 git diff。文档路径随 ECC 约定改成 .claude/specs/<stem>.md 与 .claude/plans/<stem>.md，stem 两者共用，不再带 .prd.md / .plan.md 后 缀；deriveSlug 相应改成取文件名 stem，通用文件名才退回目录名。 Claude-Session: https://claude.ai/code/session_01REdhpbaNyqWASF2HWsnTFv
This commit is contained in:
cruldra committed
1 parent
ef0750b4ef
commit
518d471b7a
11 files changed
+60
-58
No files matched your search
@@ -1,30 +1,30 @@
|
||||
/ecc:plan-prd 讨论下 {issueNumber} 号工单
|
||||
/ecc:grilling 讨论下 {issueNumber} 号工单
|
||||
|
||||
用 tea 命令找工单，用 grill-me skill 讨论细节，用表单形式和我交互，每次只问一个问题（`/ecc:plan-prd` 里成组的问题也拆成一次一问）。
|
||||
用 tea 命令找工单，用 `ecc:grilling` 技能讨论细节，用表单形式和我交互，每次只问一个问题（成组的问题也拆成一次一问）。
|
||||
|
||||
## 产物与顺序
|
||||
|
||||
1. 需求讨论清楚后，按 `/ecc:plan-prd` 的模板写 PRD 到 `.claude/prds/<slug>.prd.md`，让我确认。
|
||||
2. PRD 我确认后，用 Skill 工具调 `ecc:plan`，参数是 PRD 路径，产出 `.claude/plans/<slug>.plan.md`；计划出来后停下等我确认。
|
||||
3. `<slug>` 取工单标题的英文短横线名，PRD 与计划共用；工单已有 marker 就沿用其中的 slug。
|
||||
1. 需求讨论到共识后，用 Skill 工具调 `ecc:spec` 写设计文档到 `.claude/specs/<stem>.md`，让我确认。
|
||||
2. 设计文档我确认后，用 Skill 工具调 `ecc:plan`，参数是设计文档路径，产出 `.claude/plans/<stem>.md`；计划出来后停下等我确认。
|
||||
3. `<stem>` 取工单标题的英文短横线名，设计文档与计划共用同一个 stem；文件名里不要带 `spec` / `plan` 字样，目录已经表达了。工单已有 marker 就沿用其中的 stem。
|
||||
|
||||
## marker 维护（本会话有效）
|
||||
|
||||
PRD / 计划文件**一律在当前主 worktree（main 分支）创建并提交**，每次只提交这两个文件（提交信息形如 `📝 docs: #<工单号> 需求文档` / `📝 docs: #<工单号> 实施计划`），不要为此新建或切换分支。创建后追加对应 marker：
|
||||
设计文档 / 计划文件**一律在当前主 worktree（main 分支）创建并提交**（`ecc:spec` 默认不提交，这里要显式提交），每次只提交这两个文件（提交信息形如 `📝 docs: #<工单号> 设计文档` / `📝 docs: #<工单号> 实施计划`），不要为此新建或切换分支。创建后追加对应 marker：
|
||||
|
||||
```
|
||||
opencli spx issue marker --issue <工单号> --type spec --value .claude/prds/<slug>.prd.md
|
||||
opencli spx issue marker --issue <工单号> --type plan --value .claude/plans/<slug>.plan.md
|
||||
opencli spx issue marker --issue <工单号> --type spec --value .claude/specs/<stem>.md
|
||||
opencli spx issue marker --issue <工单号> --type plan --value .claude/plans/<stem>.md
|
||||
```
|
||||
|
||||
## 严禁擅自继续
|
||||
|
||||
如果你创建/更新了 PRD 或计划文件并 marker 已同步，**立即停下**汇报；不要进入实施流程。
|
||||
如果你创建/更新了设计文档或计划文件并 marker 已同步，**立即停下**汇报；不要进入实施流程。
|
||||
|
||||
特别地：
|
||||
|
||||
- 不要创建分支
|
||||
- 不要切换分支，包括 `git checkout` / `git switch`
|
||||
- 除 PRD / 计划文件外不要修改任何文件
|
||||
- 除设计文档 / 计划文件外不要修改任何文件
|
||||
- 不要创建 PR
|
||||
- 不要调用 gitea 其他写操作（除上面的 marker 同步）
|
||||
@@ -25,20 +25,20 @@ opencli spx issue create --title "<标题>" --body-file /tmp/issue-body.md
|
||||
|
||||
spx 返回工单号 + html_url。记下工单号，后续命令用。
|
||||
|
||||
## 后续需求文档 / 计划维护（本会话有效）
|
||||
## 后续设计文档 / 计划维护（本会话有效）
|
||||
|
||||
需求与计划走 ECC 工作流：`/ecc:plan-prd` 产出需求文档（PRD），`/ecc:plan <PRD 路径>` 产出实施计划。文件路径固定：
|
||||
需求与计划走 ECC 工作流：`/ecc:grilling` 讨论需求，`/ecc:spec` 产出设计文档，`/ecc:plan <设计文档路径>` 产出实施计划。文件路径固定：
|
||||
|
||||
- PRD：`.claude/prds/<slug>.prd.md`
|
||||
- 计划：`.claude/plans/<slug>.plan.md`
|
||||
- 设计文档：`.claude/specs/<stem>.md`
|
||||
- 计划：`.claude/plans/<stem>.md`
|
||||
|
||||
`<slug>` 取工单标题的英文短横线名（如 `app-entity`），PRD 与计划用同一个 slug。两个文件**一律在当前主 worktree（main 分支）创建并提交**，每次只提交这两个文件（提交信息形如 `📝 docs: #<工单号> 需求文档` / `📝 docs: #<工单号> 实施计划`）；实施 worktree 从 main 当前提交切出，没提交的文件在那边看不到。
|
||||
`<stem>` 取工单标题的英文短横线名（如 `app-entity`），两个文件用同一个 stem，文件名里不要带 `spec` / `plan` 字样。两个文件**一律在当前主 worktree（main 分支）创建并提交**（`ecc:spec` 默认不提交，这里要显式提交），每次只提交这两个文件（提交信息形如 `📝 docs: #<工单号> 设计文档` / `📝 docs: #<工单号> 实施计划`）；实施 worktree 从 main 当前提交切出，没提交的文件在那边看不到。
|
||||
|
||||
**只有**当你真正创建了 PRD 或计划文件后才追加对应 marker：
|
||||
**只有**当你真正创建了设计文档或计划文件后才追加对应 marker：
|
||||
|
||||
```
|
||||
opencli spx issue marker --issue <工单号> --type spec --value .claude/prds/<slug>.prd.md
|
||||
opencli spx issue marker --issue <工单号> --type plan --value .claude/plans/<slug>.plan.md
|
||||
opencli spx issue marker --issue <工单号> --type spec --value .claude/specs/<stem>.md
|
||||
opencli spx issue marker --issue <工单号> --type plan --value .claude/plans/<stem>.md
|
||||
```
|
||||
|
||||
spx 自动找到对应行替换或追加，保留所有其他 marker。**不要自己手写 `<!-- spx:* -->` 行**。
|
||||
@@ -51,4 +51,4 @@ spx 自动找到对应行替换或追加，保留所有其他 marker。**不要
|
||||
|
||||
- 不要创建分支
|
||||
- 不要切换分支
|
||||
- 除 PRD / 计划文件外不要改动或提交任何文件
|
||||
- 除设计文档 / 计划文件外不要改动或提交任何文件
|
||||
@@ -1,6 +1,6 @@
|
||||
/ecc:tdd-workflow @{planFile}
|
||||
/ecc:tdd @{planFile}
|
||||
|
||||
按计划实施 {issueNumber} 号工单：具体编码派子代理去做，全程保持测试绿灯。计划里的验证命令只当意图，落地时用仓库自己的 test / lint / typecheck 命令。提 PR 前先 `/ecc:code-review` 自审并修掉严重问题。发起 PR 时务必在 PR body 中包含 "Closes #{issueNumber}"。
|
||||
按计划实施 {issueNumber} 号工单：具体编码派子代理去做，全程保持测试绿灯。计划里的验证命令只当意图，落地时用仓库自己的 test / lint / typecheck 命令。提 PR 前先自审并修掉严重问题：把 `git diff origin/main...HEAD` 交给 `ecc:code-reviewer` 子代理（`/ecc:code-review` 的本地模式只看未提交改动，提交过就看不到了）。发起 PR 时务必在 PR body 中包含 "Closes #{issueNumber}"。
|
||||
|
||||
**严禁合并 PR**：你的职责只到发起 PR 为止，后续审查反馈到了请继续修复并 push，永远不要执行 `tea pulls merge` 或任何合并操作。
|
||||
|
||||
|
||||
@@ -1,7 +1,17 @@
|
||||
/review 审查这个仓库的 PR #{prNumber}。
|
||||
审查这个仓库的 PR #{prNumber}。
|
||||
|
||||
用 `tea pulls {prNumber}` 看 PR 元信息（标题/描述/分支）。看代码差异用 git（当前目录就是 PR 分支的 worktree）：先 `git fetch origin main`，再 `git diff origin/main...HEAD`（概览可加 --stat）。注意 tea 没有 `diff` 子命令，不要尝试 `tea pulls diff`。
|
||||
|
||||
## 审查方式
|
||||
|
||||
ECC 的 `/ecc:review-pr` 和 `/ecc:code-review` 的 PR 模式都走 `gh`，对 Gitea 不可用，不要调。直接把上面的 diff 喂给 ECC 的审查子代理，按改动涉及的语言挑：
|
||||
|
||||
- `ecc:code-reviewer`（必跑）
|
||||
- `ecc:silent-failure-hunter`、`ecc:pr-test-analyzer`（必跑）
|
||||
- 语言专项：TypeScript 用 `ecc:typescript-reviewer`，Python 用 `ecc:python-reviewer`，React 用 `ecc:react-reviewer`，其余同理
|
||||
|
||||
汇总时去重、按严重程度排序，只报置信度高的问题。
|
||||
|
||||
## 提交审查意见
|
||||
|
||||
把审查意见（markdown 格式）写到 `/tmp/review-{prNumber}.md`，调 spx：
|
||||
|
||||
Reference in new issue
Block a user