@chenmk/superflow 0.1.2 → 0.1.3

package/assets/skills/superflow-pipeline/references/implementation-prompt-template.md

@@ -6,7 +6,7 @@
 
 ## Copy-Paste 版本
 
-```
+````
 使用superpower技能，开启合适的团队，最少包含一名开发和一名测试交叉验证进行需求开发，测试验证闭环交付，更新测试文档和api.md：
 
 你是本次开发任务的 Leader Agent，负责指挥一个 Agent Team 完成编码实现。
@@ -85,7 +85,7 @@ Worker 自测通过 ≠ 完成任务
 ~/.codex/skills/superflow-pipeline/scripts/superflow-state.sh set {change-dir} review_mode standard
 ~/.codex/skills/superflow-pipeline/scripts/superflow-state.sh set {change-dir} implementation_prompt prompt/{batch-prompt}.md
 ~/.codex/skills/superflow-pipeline/scripts/superflow-state.sh set {change-dir} worktree_ports "{derived-port}"
-```
+````
 
 `review_mode` 必须在 `off|standard|thorough` 中选择。full workflow 默认
 `standard`；高风险跨仓/接口/DB/第三方任务使用 `thorough`；只有纯文本或明确低风险
@@ -129,19 +129,32 @@ Worker 自测通过 ≠ 完成任务
 从 [design.md](../design.md) 复制本批涉及字段的语义合同，并在当前源码、Mapper/XML
 和数据库样例中复核。必须填写：
 
-| 字段 | 来源表/DTO/事件 | 真实语义 | 目标字段 | 目标语义 | 是否可等价 | 证据锚点 | 禁止用法 | 不确定项/owner |
-|------|-----------------|----------|----------|----------|------------|----------|----------|----------------|
-| ____ | ____ | ____ | ____ | ____ | 是/否 | 文件/SQL/样例 | ____ | ____ |
+| 字段     | 来源表/DTO/事件 | 真实语义 | 目标字段 | 目标语义 | 是否可等价 | 证据锚点      | 禁止用法 | 不确定项/owner |
+| -------- | --------------- | -------- | -------- | -------- | ---------- | ------------- | -------- | -------------- |
+| \_\_\_\_ | \_\_\_\_        | \_\_\_\_ | \_\_\_\_ | \_\_\_\_ | 是/否      | 文件/SQL/样例 | \_\_\_\_ | \_\_\_\_       |
 
 字段语义未确认时，停止并报告 `Blocked`。禁止凭字段名相似、类型相同或值非空继续实现。
 
+### 1.1 外部枚举绑定确认
+
+如果本批涉及第三方、SDK、BEM/停车、支付退款、财务展示、来源字段、状态同步、
+外部字典或外部枚举，必须从 api.md / sdd-quality-gate.md /
+Superpowers 技术详设复制 `外部枚举绑定确认` / `External Enum Binding`，并在编码前复核：
+
+| 业务字段 | 本系统真源字段/枚举 | 外部系统字段 | 外部枚举/字典值 | 展示文案/业务语义/财务语义 | 取值来源                    | owner/确认时间 | 不确定项/阻塞处理      | 测试证据                |
+| -------- | ------------------- | ------------ | --------------- | -------------------------- | --------------------------- | -------------- | ---------------------- | ----------------------- |
+| \_\_\_\_ | \_\_\_\_            | \_\_\_\_     | \_\_\_\_        | \_\_\_\_                   | 文档/日志/接口样例/用户确认 | \_\_\_\_       | 无 / Blocked: \_\_\_\_ | TC-\_\_\_ / test-report |
+
+禁止用请求成功、值非空或字段存在替代外部枚举业务语义确认。未确认的外部枚举、
+支付来源、财务展示含义或兜底映射，必须停止并报告 `Blocked`。
+
 ### 2. 写入闭环
 
 凡本批涉及回填、落库、绑定、持久化、快照、同步、状态推进，必须填写：
 
-| 业务动作 | Java setter/赋值点 | Converter/DTO 映射 | Mapper insert/update | DB column | 后续读取方 | 消费入口 | 验证 SQL | 测试用例 |
-|----------|--------------------|--------------------|----------------------|-----------|------------|----------|----------|----------|
-| ____ | ____ | ____ | ____ | ____ | ____ | ____ | SELECT ... | TC-___ |
+| 业务动作 | Java setter/赋值点 | Converter/DTO 映射 | Mapper insert/update | DB column | 后续读取方 | 消费入口 | 验证 SQL   | 测试用例  |
+| -------- | ------------------ | ------------------ | -------------------- | --------- | ---------- | -------- | ---------- | --------- |
+| \_\_\_\_ | \_\_\_\_           | \_\_\_\_           | \_\_\_\_             | \_\_\_\_  | \_\_\_\_   | \_\_\_\_ | SELECT ... | TC-\_\_\_ |
 
 只看到 Java setter 不算落库证明；必须核对 Mapper/XML、注解 SQL、BaseMapper、
 resultMap、条件更新和后续读取方。成组字段必须整组验证。
@@ -150,15 +163,16 @@ resultMap、条件更新和后续读取方。成组字段必须整组验证。
 
 必须按真实用户或真实系统入口填写：
 
-| 用户/外部动作 | 上游服务/接口 | 本仓入口 | MQ/异步回调 | 关键字段变化 | DB 状态 | 结算/通知/展示消费点 | 真实验证方式 |
-|---------------|---------------|----------|-------------|--------------|---------|----------------------|--------------|
-| ____ | ____ | ____ | ____ | ____ | ____ | ____ | curl/日志/DB |
+| 用户/外部动作 | 上游服务/接口 | 本仓入口 | MQ/异步回调 | 关键字段变化 | DB 状态  | 结算/通知/展示消费点 | 真实验证方式 |
+| ------------- | ------------- | -------- | ----------- | ------------ | -------- | -------------------- | ------------ |
+| \_\_\_\_      | \_\_\_\_      | \_\_\_\_ | \_\_\_\_    | \_\_\_\_     | \_\_\_\_ | \_\_\_\_             | curl/日志/DB |
 
 测试 Controller、mock endpoint、绕过鉴权端点只能作为局部证据，不能替代真实入口。
 
 ### 4. 禁止 fallback 与猜测实现
 
 默认禁止以下行为：
+
 - 默认值、兜底反查、替代字段、保留旧值、空值转可用、静默跳过。
 - 在下游结算/展示/通知层补偿上游本该写入的业务快照。
 - 只为让测试通过而改断言、改入参、改口径。
@@ -166,16 +180,16 @@ resultMap、条件更新和后续读取方。成组字段必须整组验证。
 若确实需要兼容历史脏数据或外部不可控输入，必须先记录并获得 owner 确认：
 
 | 兜底触发条件 | 业务依据 | 会掩盖的异常 | 暴露/告警方式 | 移除条件 | owner确认 |
-|--------------|----------|--------------|---------------|----------|-----------|
-| ____ | ____ | ____ | ____ | ____ | ____ |
+| ------------ | -------- | ------------ | ------------- | -------- | --------- |
+| \_\_\_\_     | \_\_\_\_ | \_\_\_\_     | \_\_\_\_      | \_\_\_\_ | \_\_\_\_  |
 
 ### 5. Agent 执行前自检
 
 编码前必须填写，任一项为否或不确定则停止：
 
-| 真实入口已定位 | 字段语义合同已核对 | 写入闭环已核对 | 禁止兜底边界已确认 | RED 测试已执行 | 允许修改文件 | 禁止修改文件 | 阻塞项 |
-|----------------|--------------------|----------------|----------------------|----------------|--------------|--------------|--------|
-| 是/否 | 是/否 | 是/否 | 是/否 | 是/否 | ____ | ____ | ____ |
+| 真实入口已定位 | 字段语义合同已核对 | 写入闭环已核对 | 禁止兜底边界已确认 | RED 测试已执行 | 允许修改文件 | 禁止修改文件 | 阻塞项   |
+| -------------- | ------------------ | -------------- | ------------------ | -------------- | ------------ | ------------ | -------- |
+| 是/否          | 是/否              | 是/否          | 是/否              | 是/否          | \_\_\_\_     | \_\_\_\_     | \_\_\_\_ |
 
 ## 项目信息
 
@@ -307,13 +321,14 @@ curl -s -H "token: $TOKEN" ...
 
 本项目使用 {BUILD_TOOL}，命令如下：
 
-| 操作 | 命令 |
-|------|------|
+| 操作 | 命令          |
+| ---- | ------------- |
 | 编译 | {compile-cmd} |
-| 启动 | {run-cmd} |
-| 测试 | {test-cmd} |
+| 启动 | {run-cmd}     |
+| 测试 | {test-cmd}    |
 
 ⚠️ 关键警告：
+
 - Gradle 启动 Spring Profile 必须用 --args='--spring.profiles.active=xxx'
 - 绝对不能用 -Dspring-boot.run.profiles=xxx（这是 Maven 的语法，Gradle 会忽略）
 - 每次修改后必须先 clean 再编译，不能依赖增量编译
@@ -387,9 +402,9 @@ done
 6. 字段迁移后必须同步查询逻辑，例如旧 `status` 持久化字段改为派生状态、旧 `plot_id` 改为多站点快照字段。
 7. 在 test-report 填写：
 
-| 表 | 真源结构 | 消费仓 | 实体/Mapper/SQL 字段 | 实际库字段 | 处理结论 | 验证证据 |
-|----|----------|--------|----------------------|------------|----------|----------|
-| ____ | ____ | ____ | ____ | ____ | 通过/阻塞/已修复 | ____ |
+| 表       | 真源结构 | 消费仓   | 实体/Mapper/SQL 字段 | 实际库字段 | 处理结论         | 验证证据 |
+| -------- | -------- | -------- | -------------------- | ---------- | ---------------- | -------- |
+| \_\_\_\_ | \_\_\_\_ | \_\_\_\_ | \_\_\_\_             | \_\_\_\_   | 通过/阻塞/已修复 | \_\_\_\_ |
 
 任一消费仓存在不存在列或旧查询条件时，本批次不得标记完成。
 
@@ -407,6 +422,7 @@ done
 8. 任务完成前必须回查版本总 SQL：本批新增/修改的表、字段、索引、默认值、初始化数据必须已合并进需求级汇总 SQL 文件，不能只存在于开发库、临时脚本或 agent 回复中。
 
 **禁止事项：**
+
 - 禁止为绕过数据库缺字段、缺默认值、缺初始化数据而修改业务逻辑（如加 if-null 判断兼容缺失字段、用硬编码代替数据库默认值）。
 - 禁止自行创建独立 SQL 文件。所有 SQL 脚本必须追加到需求级汇总 SQL 文件。
 - 禁止把 SQL 写在临时说明里但不追加到需求汇总 SQL 文件。
@@ -415,6 +431,7 @@ done
 - 禁止因为开发库已经存在字段就跳过总 SQL 收口；发布以版本总 SQL 为准。
 
 **任务完成前必须输出 SQL 收口对账表：**
+
 ```
 版本总 SQL 收口对账：
 | P编号 | 表 | 字段/索引/数据 | 源码引用 | 总SQL位置 | 开发库状态 | 测试库状态 | 处理结论 |
@@ -423,6 +440,7 @@ done
 ```
 
 **任务交付报告中必须包含的数据库核查章节：**
+
 ```
 数据库结构核查：
 - 检查的表/字段/索引/初始化数据：{列出具体检查项}
@@ -436,6 +454,7 @@ done
 ## 强制执行顺序（数据库迁移类任务硬门禁）
 
 **自动检测规则**：生成本 prompt 时，如本批次涉及以下任一条件，则**必须**包含本章节，不可跳过、不可绕行：
+
 - 新增表
 - 删除字段
 - 物理删除旧字段
@@ -485,6 +504,7 @@ done
    - 禁止只靠 `BUILD SUCCESS` 或编译通过宣称完成
 
 **禁止事项：**
+
 - 禁止为绕过数据库缺字段、缺默认值、缺初始化数据、历史数据未迁移而修改业务逻辑
 - 禁止自行创建独立 SQL 文件。所有 SQL 脚本必须追加到需求级汇总 SQL 文件
 - 禁止把 SQL 写在临时说明里但不追加到需求汇总 SQL 文件
@@ -516,21 +536,25 @@ done
 从 api.md 提取接口矩阵后，必须执行以下对账检查：
 
 ### 检查 1：动作-接口映射对账
+
 - 每个前端按钮是否在 api.md 有对应接口定义？
 - 每个 api.md 接口是否在 Controller 有对应 mapping？
 - api.md 中的固定路径（如 `/export`、`/template`）是否可能与 `{id}` 路径变量冲突？
 
 ### 检查 2：文件流接口对账
+
 - 导出/下载接口在 api.md 是否标注为文件流？
 - 对应 Controller 方法是否直接操作 HttpServletResponse 而非返回 Response<T>？
 - 是否设置了 Content-Type 和 Content-Disposition？
 
 ### 检查 3：导入接口对账
+
 - failureCount > 0 时，业务 code 是否为非 0？
 - Excel 模板下载 DTO 和导入解析 DTO 的列头是否一致？
 - 日期字段是否兼容 yyyy-MM-dd 和 yyyy-MM-dd HH:mm:ss？
 
 ### 检查 4：数据权限决策对账
+
 - 每个访问业务数据的接口是否都有数据权限判断（需要/不需要/不确定）？
 - 如果判断为"需要"，是否已调查当前仓库已有权限模型并写明复用方案？
 - 如果判断为"不需要"，是否写明了原因？
@@ -539,12 +563,14 @@ done
 - 详情/编辑/删除是否做了越权保护？
 
 ### 检查 5：外部依赖对账
+
 - SDK 调用参数是否有来源说明？
 - 是否已记录真实请求/响应或标记阻塞？
 
 ## Phase 2: 创建 Agent Team
 
 创建 Team，成员如下：
+
 - **Leader**: 你（协调、集成验证、亲自执行回归测试）
 - **Worker-1（至少保留）**: Group A - {task-list-1}
 - **Worker-2（可选）**: Group B - {task-list-2}
@@ -554,7 +580,7 @@ done
 
 ## Phase 3: 给每个 Worker 的 Prompt 模板
 
-```
+````
 你是 Worker Agent，负责执行分配给你的开发任务。
 
 ### 核心原则
@@ -575,7 +601,8 @@ done
 pwd
 git branch --show-current
 git status --short
-```
+````
+
 - 确认当前目录包含本批次 worktree 名称
 - 确认当前分支是本批次分支
 - 如有异常，停止工作，向 Leader 报告
@@ -583,6 +610,7 @@ git status --short
 步骤 0.5: 数据库前置门禁与强制执行顺序（写代码前必须执行，不可跳过）
 
 **一般任务（仅字段/索引变更，无历史数据迁移）：**
+
 - 对照 design.md / tasks.md 列出本 Worker 任务依赖的表、字段、索引、默认值
 - 连接开发环境数据库，执行 SHOW CREATE TABLE / SHOW COLUMNS / SELECT 确认结构
 - 如果发现缺失，从需求汇总 SQL 文件中找到对应脚本执行到开发环境数据库
@@ -618,6 +646,7 @@ git status --short
    - 禁止只靠 BUILD SUCCESS 或编译通过宣称完成
 
 **通用禁止：**
+
 - 禁止因为字段缺失而在业务代码里写绕过逻辑
 - 禁止自行创建独立 SQL 文件，所有 SQL 统一追加到需求级汇总 SQL 文件
 - 禁止用 mock/单测/BUILD SUCCESS 代替真实数据库结构核查和数据迁移验证
@@ -626,24 +655,26 @@ git status --short
 步骤 1: 读取 design.md 对应章节，理解设计
 步骤 2: 修改代码（所有编辑操作必须在 worktree 目录内完成）
 步骤 3: 代码自审（必须先做，不能跳过）
-  - 重新读取修改后的文件，逐行检查
-  - 对照 design.md 检查是否按设计实现
-  - 重点检查：空指针风险、异常处理、事务边界、日志规范
-  - **文件流接口检查**：导出/下载方法是否直接操作 HttpServletResponse？是否设置了 Content-Type 和 Content-Disposition？是否避免了被统一 JSON 包装？
-  - **导入接口检查**：failureCount > 0 时业务 code 是否非 0？Excel 列头是否与模板一致？日期格式是否兼容 yyyy-MM-dd？
-  - **路由检查**：新增的固定路径是否可能被现有 `{id}` 路径变量抢占？
-  - **数据权限检查**：访问业务数据的接口是否按 api.md 的数据权限决策实现了？是否复用了当前仓库已有权限模式？是否避免了凭字段名猜测？
-  - **外部 SDK 检查**：SDK 参数是否有来源说明？是否凭字段名猜测？
-  - 使用 `code-review-java` skill 进行评审
-  - 发现问题立即修复，修复后重新自审
-  - 自审未通过不得进入编译环节
-步骤 4: 停止旧进程
+
+- 重新读取修改后的文件，逐行检查
+- 对照 design.md 检查是否按设计实现
+- 重点检查：空指针风险、异常处理、事务边界、日志规范
+- **文件流接口检查**：导出/下载方法是否直接操作 HttpServletResponse？是否设置了 Content-Type 和 Content-Disposition？是否避免了被统一 JSON 包装？
+- **导入接口检查**：failureCount > 0 时业务 code 是否非 0？Excel 列头是否与模板一致？日期格式是否兼容 yyyy-MM-dd？
+- **路由检查**：新增的固定路径是否可能被现有 `{id}` 路径变量抢占？
+- **数据权限检查**：访问业务数据的接口是否按 api.md 的数据权限决策实现了？是否复用了当前仓库已有权限模式？是否避免了凭字段名猜测？
+- **外部 SDK 检查**：SDK 参数是否有来源说明？是否凭字段名猜测？
+- 使用 `code-review-java` skill 进行评审
+- 发现问题立即修复，修复后重新自审
+- 自审未通过不得进入编译环节
+  步骤 4: 停止旧进程
   pkill -f "spring-boot:run" 2>/dev/null || true
   pkill -f "GradleDaemon" 2>/dev/null || true
   sleep 2
-步骤 5: 确认端口已释放
-  netstat -tlnp | grep {port}  # 应该无输出
-步骤 6: 检查端口占用（必须先做，再编译）
+  步骤 5: 确认端口已释放
+  netstat -tlnp | grep {port} # 应该无输出
+  步骤 6: 检查端口占用（必须先做，再编译）
+
 ```bash
 PORT={port}
 # 检查端口占用
@@ -658,9 +689,11 @@ if lsof -i :$PORT > /dev/null 2>&1 || netstat -tlnp 2>/dev/null | grep -q ":$POR
   done
 fi
 ```
+
 - 如果更换了端口，后续所有 URL 必须同步使用新端口
 
 步骤 7: 重新编译（必须先 clean）
+
 ```bash
 {compile-cmd}
 ```
@@ -693,12 +726,14 @@ fi
 ```
 
 **关键原则**：
+
 - 其他 agent 能正常编译启动，说明环境和配置是对的
 - 遇到问题时，先检查自己的代码修改，而非假设环境有问题
 - 必须尝试修复，不能一遇到错误就放弃
 - 修复后必须重新 clean compile，确认 BUILD SUCCESS
 
 步骤 8: 启动应用（记录 PID）
+
 ```bash
 # 先停止自己的旧进程（只停自己的，不碰别人的）
 pkill -f "spring-boot:run" 2>/dev/null || true
@@ -709,45 +744,48 @@ nohup {run-cmd} > app.log 2>&1 &
 echo $! > /tmp/app.pid
 sleep 15
 ```
+
 - 如果使用了新端口，run-cmd 中必须传入新端口（如 --server.port=$PORT）
-步骤 9: 进程验证（必须执行）
+  步骤 9: 进程验证（必须执行）
   - 检查 PID: ps -o pid,lstart,cmd -p $(cat /tmp/app.pid)
   - 检查端口: netstat -tlnp | grep $PORT 或 lsof -i :$PORT
   - 检查日志: tail -30 app.log | grep "Started Application\|JVM running"
   - 确认启动时间是本次启动
   - 如果用了新端口，确认新端口确实被本进程监听
-步骤 10: 健康检查
-  curl -s http://localhost:$PORT{context-path}/actuator/health | grep UP
-步骤 11: 获取测试 Token（严格按 Token 获取规范执行）
+    步骤 10: 健康检查
+    curl -s http://localhost:$PORT{context-path}/actuator/health | grep UP
+    步骤 11: 获取测试 Token（严格按 Token 获取规范执行）
   - 调用 /captcha/image 获取验证码（带 Cookie）
   - 调用 /login 表单提交获取 token
   - 验证 token 非空且不为 null
-步骤 12: 执行 RED 验证（必须在生产代码修改前完成）
+    步骤 12: 执行 RED 验证（必须在生产代码修改前完成）
   - 从 tests.md 提取本批次用例 ID 和自动化命令
   - 运行目标单测/接口自动化命令，确认失败原因是预期业务断言
   - 记录命令、失败摘要、失败断言到 test-report 的 RED 失败证据
   - RED 未正确失败时不得继续编码
-步骤 13: 执行接口验证 Checklist（逐项执行，来自 tests.md L3 用例）
+    步骤 13: 执行接口验证 Checklist（逐项执行，来自 tests.md L3 用例）
   - 按照 Phase 4.5 的 checklist 逐项执行 curl 命令
   - 记录每个用例的请求、响应和断言结果
   - 未全部勾选不得报告完成
-步骤 14: 数据库验证
+    步骤 14: 数据库验证
   - 执行 SHOW CREATE TABLE 确认结构
   - 执行 SELECT 查询确认数据状态
-步骤 15: 日志检查
+    步骤 15: 日志检查
   - grep ERROR app.log
   - 确认无 ERROR
-步骤 16: 回填 test-report.md
+    步骤 16: 回填 test-report.md
   - 记录 RED、GREEN、curl、响应、DB 查询、日志检查结果
-步骤 17: 执行 SDD 集成验收脚本（必须执行）
-  ~/.codex/hooks/superflow-verify-integration.sh \
-    {project-path}/doc/openspec/changes/{change-id}/embedded-changes/pXX-xxx/test-report.md
+    步骤 17: 执行 SDD 集成验收脚本（必须执行）
+    ~/.codex/hooks/superflow-verify-integration.sh \
+     {project-path}/doc/openspec/changes/{change-id}/embedded-changes/pXX-xxx/test-report.md
   - 脚本失败时不得提交、不得交付、不得写"后续补测"
   - 必须补齐真实启动、curl、DB、日志证据后重跑
-步骤 18: 报告开发完成，等待 Tester 独立测试
+    步骤 18: 报告开发完成，等待 Tester 独立测试
 
 ### 报告格式
+
 开发完成报告：
+
 - 任务 ID: {task-id}
 - 状态: 开发完成，等待独立测试
 - 修改文件: {file}
@@ -783,25 +821,31 @@ sleep 15
 - test-report 已回填: {是 / 否}
 - SDD 集成验收脚本: {通过 / 失败，失败时贴出原因}
 - 说明: 应用已启动，接口已验证，等待独立 Tester 测试验证
+
 ```
 
 ## Phase 3b: 给 Tester 的 Prompt 模板
 
 ```
+
 你是独立测试 Agent（Tester），负责验证 Worker 的开发成果。
 
 ### 核心原则
+
 - **与 Worker 完全分离**：不参考 Worker 的自测报告，独立从头执行测试
 - **客观报告**：如实报告失败，不替 Worker 找理由
 - **覆盖全部用例**：执行 tests.md 中所有标注 [自动化] 的用例
 
 ### 你的任务
+
 测试 Worker 完成的任务：{task-id}
 
 ### 参考文档
+
 - tests.md: {project-path}/doc/openspec/changes/{change-id}/tests.md
 
 ### 执行流程
+
 步骤 1: 读取 tests.md 对应章节的全部用例
 步骤 2: 独立执行接口测试（curl）
 步骤 3: 独立执行数据库验证（mysql 查询）
@@ -809,7 +853,9 @@ sleep 15
 步骤 5: 向 Leader 报告客观结果
 
 ### 报告格式
+
 独立测试报告：
+
 - 任务 ID: {task-id}
 - 测试人: Tester（独立）
 - 测试用例: 共 X 个，执行 X 个，通过 X 个，失败 X 个
@@ -819,6 +865,7 @@ sleep 15
 - 数据库验证: ...
 - 日志检查: ...
 - 结论: 通过 / 不通过
+
 ```
 
 ## Phase 4: 集成验证（你亲自执行）
@@ -1040,17 +1087,17 @@ Worker 完成编码和启动后，必须按以下 checklist 逐项执行接口
 3. 粘贴给新 Agent 执行
 4. 关键占位符对照表：
 
-| 占位符 | 说明 | 示例 |
-|--------|------|------|
-| `{change-id}` | 变更目录名 | `3.24.0.2-fix-debug-status-and-light-on-bind` |
-| `{project-path}` | 项目绝对路径 | `/home/ake-yanfa/IdeaProjects/MPGS/park-mpgs` |
-| `{maven-or-gradle}` | 构建工具 | `Gradle` |
-| `{profile-name}` | Spring Profile | `cmk` |
-| `{base-port}` | 应用基础端口号（配置文件中） | `9250` |
-| `{batch-id}` | 批次序号 | `15` |
-| `{port}` | 计算端口 = base-port + batch-id | `9265` |
-| `{context-path}` | 上下文路径 | `/mpgs` |
-| `{compile-cmd}` | 编译命令 | `./gradlew clean compileJava -x test` |
-| `{run-cmd}` | 启动命令 | `./gradlew bootRun --args='--spring.profiles.active=cmk'` |
-| `{task-list-N}` | 分配给 Worker 的任务 | `Task 5.1, Task 7.1, Task 9.1` |
-| `{curl-examples}` | curl 命令示例 | 从 tests.md 提取 |
+| 占位符              | 说明                            | 示例                                                      |
+| ------------------- | ------------------------------- | --------------------------------------------------------- |
+| `{change-id}`       | 变更目录名                      | `3.24.0.2-fix-debug-status-and-light-on-bind`             |
+| `{project-path}`    | 项目绝对路径                    | `/home/ake-yanfa/IdeaProjects/MPGS/park-mpgs`             |
+| `{maven-or-gradle}` | 构建工具                        | `Gradle`                                                  |
+| `{profile-name}`    | Spring Profile                  | `cmk`                                                     |
+| `{base-port}`       | 应用基础端口号（配置文件中）    | `9250`                                                    |
+| `{batch-id}`        | 批次序号                        | `15`                                                      |
+| `{port}`            | 计算端口 = base-port + batch-id | `9265`                                                    |
+| `{context-path}`    | 上下文路径                      | `/mpgs`                                                   |
+| `{compile-cmd}`     | 编译命令                        | `./gradlew clean compileJava -x test`                     |
+| `{run-cmd}`         | 启动命令                        | `./gradlew bootRun --args='--spring.profiles.active=cmk'` |
+| `{task-list-N}`     | 分配给 Worker 的任务            | `Task 5.1, Task 7.1, Task 9.1`                            |
+| `{curl-examples}`   | curl 命令示例                   | 从 tests.md 提取                                          |