SQL Rewrite Week 1 Rollout Kit Implementation Plan¶

分支文档快照 · 同步于 2026-09-09 · 来源：origin/summer-intern @ 9f4cdc5 · 原路径：docs/superpowers/plans/2026-07-09-sql-rewrite-week1-rollout-kit.md。正文描述的是该分支的方案或进展，合入与验收状态以当前看板为准。

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Build a one-week rollout kit for the SQL rewrite project management process, including tracker, weekly report, junior developer checklist, AI prompt templates, and a short usage guide.

Architecture: This is a documentation-only implementation. The rollout kit lives under docs/project-management/sql-rewrite-week1/, with one focused Markdown or CSV file per operating artifact and a README that explains the order of use.

Tech Stack: Markdown, CSV, shell validation with rg, sed, and wc; no runtime dependencies.

Global Constraints¶

第一阶段不引入重型项目管理平台。
PM 层面不跟踪每个执行细节。
不把每条失败 SQL 都当成一个长期缺陷管理。
每日新增慢 SQL 不作为核心优化率口径，除非它们被转成可复现的 benchmark 候选。
缺陷类型固定为：SQL 能力、Agent 编排、模型输出、模型调用、数据环境。
看板泳道固定为：Benchmark 回测、SQL 能力攻关、Agent/模型可靠性、每日慢 SQL 分诊。
每周核心指标固定为：端到端达标率、流程成功率、格式合规率、语义通过率、有效改写率、Top 失败模式贡献。
周节奏固定为：周一计划会 30 分钟，周二到周四执行与攻关，周五回测与复盘 45 分钟。
产物必须能被三人团队直接复制使用，不要求新系统、新依赖或新平台。

File Structure¶

Create: docs/project-management/sql-rewrite-week1/README.md
Responsibility: Explain the rollout kit, usage order, roles, and first-week rhythm.
Create: docs/project-management/sql-rewrite-week1/tracker-template.csv
Responsibility: Provide a lightweight tracker that can be imported into a spreadsheet.
Create: docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md
Responsibility: Capture the first benchmark baseline and weekly regression comparison.
Create: docs/project-management/sql-rewrite-week1/junior-execution-checklist.md
Responsibility: Give the junior developer a concrete daily and weekly execution checklist.
Create: docs/project-management/sql-rewrite-week1/ai-prompts.md
Responsibility: Provide AI prompts for batch summary, failure clustering, defect card drafting, and PM weekly report.
Create: docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md
Responsibility: Provide the one-page PM weekly report format.

Task 1: Create Benchmark and Tracker Templates¶

Files: - Create: docs/project-management/sql-rewrite-week1/tracker-template.csv - Create: docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md

Interfaces: - Consumes: The five defect classes and six metrics defined in docs/superpowers/specs/2026-07-09-sql-rewrite-project-management-design.md. - Produces: tracker-template.csv for defect and failure-mode tracking; benchmark-baseline-template.md for weekly benchmark measurement.

Step 1: Create the target directory

Run:

mkdir -p docs/project-management/sql-rewrite-week1

Expected: command exits with code 0.

Step 2: Create tracker-template.csv

Create docs/project-management/sql-rewrite-week1/tracker-template.csv with exactly this content:

ID,来源,SQL编号,看板泳道,缺陷类型,失败阶段,失败模式,影响SQL数,负责人,状态,下一步动作,验收方式,证据链接或路径,创建日期,目标关闭日期,备注
W1-001,Benchmark,SQL-001,Benchmark 回测,SQL 能力,Phase 2.5,改写后性能未达标,1,资深开发,待分诊,确认是否属于可复用失败模式,在下一次 benchmark 中验证影响是否下降,workspace/sqls_rewrite_result.csv,2026-07-09,2026-07-11,示例行，正式使用前可删除
W1-002,Benchmark,SQL-002,Agent/模型可靠性,模型输出,Phase 2,输出不是合法 JSON,1,资深开发,待处理,收集模型原始输出并调整输出约束,同类输出错误连续两次回测不再出现,workspace/model_output.log,2026-07-09,2026-07-11,示例行，正式使用前可删除
W1-003,每日慢 SQL,SQL-DAILY-001,每日慢 SQL 分诊,数据环境,Phase 0,业务测试库无法稳定复测,1,初级开发,处理中,补齐库名实例权限和复测限制,已反馈业务方并判断是否转 benchmark 候选,workspace/daily_sql_notes.md,2026-07-09,2026-07-10,示例行，正式使用前可删除

Step 3: Create benchmark-baseline-template.md

Create docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md with exactly this content:

# SQL 改写 Benchmark 基线记录

## 批次信息

| 字段 | 内容 |
| --- | --- |
| 批次编号 | W1-BENCH-001 |
| 执行日期 | 2026-07-09 |
| 执行人 | 初级开发 |
| 数据库类型 | 分布式数据库 |
| 数据库实例 | 记录实例名 |
| SQL 总数 | 记录数量 |
| 结果 CSV | `workspace/sqls_rewrite_result.csv` |
| 关键日志 | `workspace/batch_run.log` |

## 核心指标

| 指标 | 数值 | 计算口径 |
| --- | --- | --- |
| 端到端达标率 | 记录百分比 | 达标 SQL 数 / SQL 总数 |
| 流程成功率 | 记录百分比 | 完整跑完预期阶段的 SQL 数 / SQL 总数 |
| 格式合规率 | 记录百分比 | 合法模型输出数 / 模型输出总数 |
| 语义通过率 | 记录百分比 | 语义验证通过的改写数 / 已改写 SQL 数 |
| 有效改写率 | 记录百分比 | 流程成功、语义通过且性能提升达标的 SQL 数 / 流程成功 SQL 数 |

## Top 失败模式

| 排名 | 失败模式 | 缺陷类型 | 影响 SQL 数 | 主要阶段 | 建议负责人 | 下一步动作 |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | 记录失败模式 | SQL 能力 | 记录数量 | Phase 2.5 | 资深开发 | 记录动作 |
| 2 | 记录失败模式 | Agent 编排 | 记录数量 | Phase 2-RETRY | 资深开发 | 记录动作 |
| 3 | 记录失败模式 | 模型输出 | 记录数量 | Phase 2 | 资深开发 | 记录动作 |

## 与上一批次对比

| 指标 | 上一批 | 本批 | 变化 | 结论 |
| --- | --- | --- | --- | --- |
| 端到端达标率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 流程成功率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 格式合规率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 有效改写率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |

## 本批结论

- 是否建立可信基线：是 / 否
- 是否能区分 SQL 能力问题和 Agent/模型工程问题：是 / 否
- 本周最值得优先处理的问题：记录 Top 1 问题
- 需要 PM 决策的事项：记录具体事项

Step 4: Validate files

Run:

rg -n "端到端达标率|流程成功率|格式合规率|有效改写率|SQL 能力|Agent 编排|模型输出|模型调用|数据环境" docs/project-management/sql-rewrite-week1/tracker-template.csv docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md

Expected: output includes matches from both files.

Step 5: Commit

Run:

git status --short
git add docs/project-management/sql-rewrite-week1/tracker-template.csv docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md
git commit -m "docs: add sql rewrite benchmark and tracker templates"

Expected in a valid repository: commit succeeds. In this current workspace, git status --short may fail with fatal: not a git repository; if that happens, skip the commit and report that the files were created but the workspace has no usable git metadata.

Task 2: Create Junior Developer Execution Checklist¶

Files: - Create: docs/project-management/sql-rewrite-week1/junior-execution-checklist.md

Interfaces: - Consumes: tracker-template.csv fields from Task 1. - Produces: A checklist that tells the junior developer exactly what evidence to collect before asking the senior developer for confirmation.

Step 1: Create junior-execution-checklist.md

Create docs/project-management/sql-rewrite-week1/junior-execution-checklist.md with exactly this content:

# 初级开发执行 Checklist

## 每周 Benchmark 执行

- [ ] 确认本周批次编号，例如 `W1-BENCH-001`。
- [ ] 确认使用的是稳定 benchmark 数据库，不使用每日慢 SQL 的业务测试库作为核心口径。
- [ ] 运行完整 SQL 改写流程。
- [ ] 保存结果 CSV 路径，例如 `workspace/sqls_rewrite_result.csv`。
- [ ] 保存关键日志路径，例如 `workspace/batch_run.log`。
- [ ] 记录 SQL 总数、达标 SQL 数、未达标 SQL 数。
- [ ] 标记每条失败 SQL 的失败阶段：Phase 0、Phase 1、Phase 2、Phase 2.5、Phase 2-RETRY、Phase 2.6、Phase 3。
- [ ] 对每条失败 SQL 做一级分类：SQL 能力、Agent 编排、模型输出、模型调用、数据环境。
- [ ] 使用 AI 生成失败聚类草稿。
- [ ] 将 Top 失败模式写入 `benchmark-baseline-template.md`。
- [ ] 将需要跟进的问题写入 `tracker-template.csv`。

## 每日慢 SQL 分诊

- [ ] 记录慢 SQL 来源、业务场景、数据库实例、是否可复测。
- [ ] 判断是否可以当天给出优化建议。
- [ ] 如果不能复测，记录限制原因：权限不足、环境不稳定、统计信息缺失、执行计划不可获取、业务数据不可重复。
- [ ] 如果暴露 Agent 或模型问题，转入 `Agent/模型可靠性` 泳道。
- [ ] 如果具备代表性且可复现，标记为 `转 benchmark 候选`。
- [ ] 如果只是一次性业务反馈，标记为 `已反馈` 并记录反馈内容。

## 找资深开发确认前必须准备

```text
问题标题：
来源：Benchmark / 每日慢 SQL
SQL 编号：
失败阶段：
缺陷类型：
现象：
证据路径：
疑似原因：
建议下一步动作：
需要资深开发确认的问题：

不直接升级给资深开发的情况¶

只有一句“跑失败了”，没有 SQL 编号。
没有结果 CSV 或日志路径。
没有失败阶段。
没有先做五类缺陷之一的初步分类。
没有说明希望资深开发确认什么。

每日结束前检查¶

今日新增慢 SQL 都有状态。
今日 benchmark 相关失败都已记录失败阶段。
今日新增缺陷都有证据路径。
不确定项已整理为明确问题。

明天需要继续处理的事项已写入台账。

- [ ] **Step 2: Validate checklist content**

Run:

```bash
rg -n "每周 Benchmark 执行|每日慢 SQL 分诊|找资深开发确认前必须准备|每日结束前检查" docs/project-management/sql-rewrite-week1/junior-execution-checklist.md

Expected: four section headings are matched.

Step 3: Commit

Run:

git status --short
git add docs/project-management/sql-rewrite-week1/junior-execution-checklist.md
git commit -m "docs: add junior sql rewrite execution checklist"

Expected in a valid repository: commit succeeds. In this current workspace, git status --short may fail with fatal: not a git repository; if that happens, skip the commit and report that the file was created but the workspace has no usable git metadata.

Task 3: Create AI Prompt Templates¶

Files: - Create: docs/project-management/sql-rewrite-week1/ai-prompts.md

Interfaces: - Consumes: Evidence collected by the junior developer and benchmark/tracker templates from Tasks 1 and 2. - Produces: Four copy-ready prompts: batch summary, failure clustering, defect card draft, and PM weekly report.

Step 1: Create ai-prompts.md

Create docs/project-management/sql-rewrite-week1/ai-prompts.md with exactly this content:

# SQL 改写项目 AI 提示词模板

## 使用原则

- AI 只生成初稿，不作为最终技术裁判。
- 所有结论必须引用结果 CSV、日志、SQL 编号或输出片段作为证据。
- 缺陷类型只能从五类中选择：SQL 能力、Agent 编排、模型输出、模型调用、数据环境。
- 如果证据不足，AI 必须写明“证据不足”，并列出缺少的信息。
- 输出内容优先服务 PM、资深开发、初级开发三类角色的分工。

## Prompt 1：批次摘要

```text
你是 SQL 改写项目的项目助理。请基于我提供的结果 CSV、summary 和日志，生成本批 benchmark 摘要。

请严格按以下结构输出：

1. 批次概览
- 批次编号：
- SQL 总数：
- 达标 SQL 数：
- 未达标 SQL 数：
- 结果文件：
- 日志文件：

2. 核心指标
- 端到端达标率：
- 流程成功率：
- 格式合规率：
- 语义通过率：
- 有效改写率：

3. Top 失败模式
请列出 Top 3，每个包含：
- 失败模式：
- 缺陷类型：SQL 能力 / Agent 编排 / 模型输出 / 模型调用 / 数据环境
- 影响 SQL 数：
- 主要失败阶段：
- 证据：
- 建议负责人：

4. PM 结论
- 本批是否比上一批更接近 50% 目标：
- 当前最大阻塞：
- 下周建议优先级：
- 需要 PM 决策：

如果无法计算某个指标，请写“证据不足”，并说明缺少哪些字段或日志。

Prompt 2：失败聚类¶

你是 SQL 改写项目的失败模式分析助手。请基于未达标 SQL、analyze 字段、错误日志、失败阶段和执行计划信息，将失败 SQL 聚类为可管理的失败模式。

请严格按以下结构输出：

| 排名 | 失败模式 | 缺陷类型 | 影响 SQL | 疑似阶段 | 共同特征 | 证据 | 建议负责人 | 下一步动作 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |

分类规则：
- 如果流程正常但性能无收益、语义不等价、规则缺失或分布式特征未处理，归为 SQL 能力。
- 如果 Agent 跳过阶段、参数错误、上下文缺失、Phase 2-RETRY 未触发，归为 Agent 编排。
- 如果模型输出不是合法 JSON、字段缺失、夹带解释、修改字面值或列名，归为 模型输出。
- 如果模型调用失败、超时、返回空、限流或认证失败，归为 模型调用。
- 如果数据库、权限、执行计划、统计信息或业务测试环境导致无法验证，归为 数据环境。

最后补充：
- 最值得本周优先处理的 Top 1：
- 原因：
- 验收方式：

Prompt 3：缺陷卡片草稿¶

你是 SQL 改写项目的缺陷卡片助手。请根据我提供的一条失败 SQL 或一个失败模式，生成缺陷卡片草稿。

请严格按以下模板输出：

标题：
缺陷类型：SQL 能力 / Agent 编排 / 模型输出 / 模型调用 / 数据环境
来源：Benchmark 批次 / 每日慢 SQL
影响 SQL 数：
失败阶段：Phase 0 / Phase 1 / Phase 2 / Phase 2.5 / Phase 2-RETRY / Phase 2.6 / Phase 3
现象：
证据：SQL 编号、日志、输出片段、结果 CSV
初步原因：
负责人：
下一步动作：
验收方式：

要求：
- 不要编造证据。
- 如果无法判断负责人，按规则建议：SQL 能力、Agent 编排、模型输出默认资深开发；模型调用、数据环境先由初级开发排查。
- 验收方式必须可回测或可检查，例如“下一次 benchmark 中同类失败 SQL 数下降”或“连续两次模型输出均为合法 JSON”。

Prompt 4：PM 周报¶

你是 SQL 改写项目的 PM 助理。请根据本周 benchmark 摘要、缺陷台账变化和关闭项，生成一页 PM 周报。

请严格按以下结构输出：

# SQL 改写项目周报

## 本周结论
- 一句话说明本周是否更接近 50% 目标。

## 指标变化
| 指标 | 上周 | 本周 | 变化 | 结论 |
| --- | --- | --- | --- | --- |
| 端到端达标率 |  |  |  |  |
| 流程成功率 |  |  |  |  |
| 格式合规率 |  |  |  |  |
| 有效改写率 |  |  |  |  |

## Top 3 阻塞
| 排名 | 阻塞 | 缺陷类型 | 影响 SQL 数 | 负责人 | 下周动作 |
| --- | --- | --- | --- | --- | --- |

## 已解决问题
- 列出本周关闭或明显改善的问题。

## 未解决风险
- 列出仍可能影响下周目标的问题。

## 下周建议
- 建议 Top 1-3 攻关主题。

## 需要 PM 决策
- 只列需要 PM 做资源、优先级或外部协调判断的事项。

要求：
- 不展开单条 SQL 细节。
- 明确区分 SQL 能力问题和 Agent/模型工程问题。
- 如果没有上周数据，写“本周为基线周”。

- [ ] **Step 2: Validate prompt headings**

Run:

```bash
rg -n "Prompt 1：批次摘要|Prompt 2：失败聚类|Prompt 3：缺陷卡片草稿|Prompt 4：PM 周报" docs/project-management/sql-rewrite-week1/ai-prompts.md

Expected: four prompt headings are matched.

Step 3: Commit

Run:

git status --short
git add docs/project-management/sql-rewrite-week1/ai-prompts.md
git commit -m "docs: add sql rewrite ai prompt templates"

Expected in a valid repository: commit succeeds. In this current workspace, git status --short may fail with fatal: not a git repository; if that happens, skip the commit and report that the file was created but the workspace has no usable git metadata.

Task 4: Create PM Weekly Report Template¶

Files: - Create: docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md

Interfaces: - Consumes: Batch summary and tracker outputs from Tasks 1 and 3. - Produces: A one-page PM report template focused on progress toward the 50% target.

Step 1: Create pm-weekly-report-template.md

Create docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md with exactly this content:

# SQL 改写项目周报

## 本周结论

- 本周是否更接近 50% 目标：
- 一句话判断：

## 指标变化

| 指标 | 上周 | 本周 | 变化 | 结论 |
| --- | --- | --- | --- | --- |
| 端到端达标率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 流程成功率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 格式合规率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 语义通过率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |
| 有效改写率 | 记录百分比 | 记录百分比 | 记录变化 | 记录结论 |

## Top 3 阻塞

| 排名 | 阻塞 | 缺陷类型 | 影响 SQL 数 | 负责人 | 下周动作 |
| --- | --- | --- | --- | --- | --- |
| 1 | 记录阻塞 | SQL 能力 | 记录数量 | 资深开发 | 记录动作 |
| 2 | 记录阻塞 | Agent 编排 | 记录数量 | 资深开发 | 记录动作 |
| 3 | 记录阻塞 | 模型输出 | 记录数量 | 资深开发 | 记录动作 |

## 本周关闭或改善的问题

| 问题 | 类型 | 证据 | 验收结果 |
| --- | --- | --- | --- |
| 记录问题 | 记录类型 | 记录证据路径 | 记录结果 |

## 未解决风险

| 风险 | 影响 | 负责人 | 应对动作 |
| --- | --- | --- | --- |
| 记录风险 | 记录影响 | 记录负责人 | 记录动作 |

## 下周建议

- Top 1 攻关主题：
- Top 2 攻关主题：
- Top 3 攻关主题：

## 需要 PM 决策

- 是否调整本周优先级：
- 是否需要外部业务或数据库资源：
- 是否需要暂停每日慢 SQL 中低价值问题，集中处理 benchmark 阻塞：

Step 2: Validate report template sections

Run:

rg -n "本周结论|指标变化|Top 3 阻塞|本周关闭或改善的问题|未解决风险|需要 PM 决策" docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md

Expected: six section headings are matched.

Step 3: Commit

Run:

git status --short
git add docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md
git commit -m "docs: add sql rewrite pm weekly report template"

Expected in a valid repository: commit succeeds. In this current workspace, git status --short may fail with fatal: not a git repository; if that happens, skip the commit and report that the file was created but the workspace has no usable git metadata.

Task 5: Create Rollout README and Cross-File Validation¶

Files: - Create: docs/project-management/sql-rewrite-week1/README.md - Verify: docs/project-management/sql-rewrite-week1/tracker-template.csv - Verify: docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md - Verify: docs/project-management/sql-rewrite-week1/junior-execution-checklist.md - Verify: docs/project-management/sql-rewrite-week1/ai-prompts.md - Verify: docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md

Interfaces: - Consumes: All artifacts from Tasks 1-4. - Produces: A single entry point that explains when and how the team should use the rollout kit.

Step 1: Create README.md

Create docs/project-management/sql-rewrite-week1/README.md with exactly this content:

# SQL 改写项目第一周落地包

这个目录用于把 `docs/superpowers/specs/2026-07-09-sql-rewrite-project-management-design.md` 落到第一周执行。目标不是搭系统，而是让三人团队用最少流程建立可信基线、缺陷归因和一页 PM 周报。

## 文件说明

| 文件 | 用途 | 主要使用者 |
| --- | --- | --- |
| `tracker-template.csv` | 轻量台账模板，可导入表格工具 | 初级开发、资深开发、PM |
| `benchmark-baseline-template.md` | 记录 benchmark 基线和周回测结果 | 初级开发、PM |
| `junior-execution-checklist.md` | 初级开发每日和每周执行清单 | 初级开发 |
| `ai-prompts.md` | 批次摘要、失败聚类、缺陷卡片、PM 周报提示词 | 初级开发、PM |
| `pm-weekly-report-template.md` | 一页 PM 周报模板 | PM |

## 第一周使用顺序

1. 周一：PM 和资深开发确认本周目标，使用 `benchmark-baseline-template.md` 建立基线记录。
2. 周二到周四：初级开发按 `junior-execution-checklist.md` 跑批、收集日志、整理失败 SQL。
3. 周二到周四：初级开发使用 `ai-prompts.md` 生成批次摘要、失败聚类和缺陷卡片草稿。
4. 周二到周四：初级开发把需要跟进的问题写入 `tracker-template.csv`。
5. 周五：团队回测 benchmark，并用 `pm-weekly-report-template.md` 生成一页周报。

## 角色边界

- PM 只看指标变化、Top 阻塞、下周优先级和需要决策的事项。
- 资深开发确认失败模式归因、方案方向和高风险技术判断。
- 初级开发负责跑批、收集证据、初步分类、整理缺陷卡片。
- AI 负责生成摘要、聚类、缺陷草稿和周报初稿，不负责最终技术裁判。

## 第一周成功标准

- 有可信的 benchmark 基线。
- 每条失败 SQL 都归入五类缺陷之一。
- 团队能说清 Top 3 阻塞。
- SQL 能力问题和 Agent/模型工程问题被拆开统计。
- PM 只看一页周报，就能判断项目是否正在靠近 50% 目标。

## 使用提醒

- 不要把每日慢 SQL 直接算进核心优化率。
- 不要把每条失败 SQL 都变成长期缺陷。
- 不要让资深开发处理没有 SQL 编号、日志路径、失败阶段和初步分类的问题。
- 每周优先处理影响 SQL 数最多、最能提升端到端达标率的问题。

Step 2: Validate all expected files exist

Run:

for f in \
  docs/project-management/sql-rewrite-week1/README.md \
  docs/project-management/sql-rewrite-week1/tracker-template.csv \
  docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md \
  docs/project-management/sql-rewrite-week1/junior-execution-checklist.md \
  docs/project-management/sql-rewrite-week1/ai-prompts.md \
  docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md
do
  test -f "$f" && echo "OK $f"
done

Expected:

OK docs/project-management/sql-rewrite-week1/README.md
OK docs/project-management/sql-rewrite-week1/tracker-template.csv
OK docs/project-management/sql-rewrite-week1/benchmark-baseline-template.md
OK docs/project-management/sql-rewrite-week1/junior-execution-checklist.md
OK docs/project-management/sql-rewrite-week1/ai-prompts.md
OK docs/project-management/sql-rewrite-week1/pm-weekly-report-template.md

Step 3: Validate core vocabulary is consistent

Run:

rg -n "SQL 能力|Agent 编排|模型输出|模型调用|数据环境|端到端达标率|流程成功率|格式合规率|有效改写率" docs/project-management/sql-rewrite-week1

Expected: matches appear across the tracker, benchmark template, checklist, prompts, and PM weekly report.

Step 4: Scan for forbidden empty-detail markers

Run:

rg -n "TB[D]|TO[D]O|待[定]|placeholde[r]|implement late[r]|fill in detail[s]" docs/project-management/sql-rewrite-week1 docs/superpowers/plans/2026-07-09-sql-rewrite-week1-rollout-kit.md

Expected: no output and exit code 1.

Step 5: Commit

Run:

git status --short
git add docs/project-management/sql-rewrite-week1 docs/superpowers/plans/2026-07-09-sql-rewrite-week1-rollout-kit.md
git commit -m "docs: add sql rewrite week one rollout plan"

Expected in a valid repository: commit succeeds. In this current workspace, git status --short may fail with fatal: not a git repository; if that happens, skip the commit and report that the files were created but the workspace has no usable git metadata.

Self-Review¶

Spec coverage:

Management model is covered by Task 5 README and Task 1 benchmark/tracker templates.
Defect classes are covered by Task 1 tracker, Task 2 checklist, Task 3 prompts, and Task 4 weekly report.
Team responsibilities are covered by Task 2 checklist, Task 3 prompts, and Task 5 README.
Weekly cadence is covered by Task 5 README and Task 4 weekly report.
Metrics are covered by Task 1 benchmark template, Task 3 prompts, and Task 4 weekly report.
AI automation outputs are covered by Task 3 prompts.
First-week rollout is covered by all five tasks.

Empty-detail marker scan:

The plan avoids unfinished-work markers and vague deferred-detail markers.
Template blanks are represented as concrete labels such as 记录百分比, 记录数量, and 记录动作, because these are user-facing fields for weekly operation rather than missing implementation details.

Type consistency:

Defect classes are consistently named: SQL 能力、Agent 编排、模型输出、模型调用、数据环境.
Metrics are consistently named: 端到端达标率、流程成功率、格式合规率、语义通过率、有效改写率、Top 失败模式贡献.
The rollout directory is consistently docs/project-management/sql-rewrite-week1/.