aitable-workflow-cli 0.1.28 → 0.1.29-beta.1790736949347

package/templates/ai-native-sdlc/workflows/execution/workflow.yml

@@ -0,0 +1,79 @@
+meta:
+  id: execution
+  name: "SDLC 执行"
+  version: "1.0.0"
+  domain: ai_native_sdlc
+tracker:
+  label: "变更流水"
+  # 留空 = 搭建（setup）阶段新建 Base 与表并自动回填；与 intake 同库同批创建。
+  base_id: ""
+  table_id: ""
+  states:
+    {
+      initial: active,
+      active: [ active ],
+      review: blocked,
+      terminal: [ shipped, rejected, archived ],
+      blocked: blocked
+    }
+  fields: { state: "状态", title: "变更编号", current_step: "当前步骤", event_log: "事件日志" }
+  field_definitions:
+    - { name: "标题", type: text }
+    - { name: "需求", type: text }
+    - { name: "需求详情", type: richText }
+    - { name: "模块", type: text }
+    - {
+        name: "当前阶段",
+        type: singleSelect,
+        options: [ "PRD", "PRD 评审", "设计稿", "技术方案", "技术方案评审", "编码", "评审", "已发布" ]
+      }
+    - { name: "当前角色", type: singleSelect, options: [ "PM", "Dev", "人" ] }
+    - { name: "阻塞原因", type: text }
+    - { name: "解除条件", type: text }
+    - { name: "评审进展", type: text }
+    - { name: "AI问题", type: text }
+    - { name: "人工答复", type: text }
+    - { name: "Agent会话ID", type: text }
+    - { name: "当前CR链接", type: text }
+    - { name: "产出物", type: text }
+    - { name: "审计日志", type: text }
+    - { name: "审查轮次", type: number }
+  views:
+    - id: default_grid
+      type: Grid
+      name: "表格视图"
+      field_order:
+        [
+          "变更编号",
+          "标题",
+          "需求",
+          "需求详情",
+          "模块",
+          "当前阶段",
+          "当前角色",
+          "状态",
+          "AI问题",
+          "人工答复",
+          "当前CR链接",
+          "产出物",
+          "阻塞原因",
+          "解除条件",
+          "评审进展",
+          "当前步骤",
+          "事件日志"
+        ]
+steps:
+  - { id: prd, name: "PRD", recipe: prd, auto: true }
+  - { id: prd_review, name: "PRD 评审", recipe: prd-review, auto: true }
+  - { id: spec, name: "技术方案", recipe: spec, auto: true }
+  - { id: spec_review, name: "技术方案评审", recipe: spec-review, auto: true }
+  - { id: coding, name: "编码", recipe: coding, auto: true }
+  - { id: review, name: "评审", recipe: review, auto: true }
+edges:
+  - { from: __start__, to: prd }
+  - { from: prd, to: prd_review }
+  - { from: prd_review, to: spec }
+  - { from: spec, to: spec_review }
+  - { from: spec_review, to: coding }
+  - { from: coding, to: review }
+  - { from: review, to: __end__ }

package/templates/ai-native-sdlc/workflows/intake/automations/accept-intake.json

@@ -0,0 +1,101 @@
+{
+  "version": "workflow-dsl/v1",
+  "name": "需求受理门禁",
+  "description": "按模块配置表查询 PM负责人，由其对待评估需求作出接受或驳回决定。",
+  "trigger": "start",
+  "_tables": {
+    "module_config": {
+      "name": "模块配置表",
+      "fields": [
+        { "name": "模块名称", "type": "text" },
+        { "name": "模块说明", "type": "text" },
+        { "name": "典型例子", "type": "text" },
+        { "name": "PM负责人", "type": "user" },
+        { "name": "Dev负责人", "type": "user" }
+      ]
+    }
+  },
+  "steps": {
+    "start": {
+      "type": "WhenRecordUpdated",
+      "next": "find_module",
+      "data": {
+        "sheetId": "<sheetId>",
+        "updatedFields": ["<模块_fieldId>"],
+        "where": {
+          "and": [
+            {
+              "left": "<需求状态_fieldId>",
+              "op": "EQ",
+              "right": { "option": "<需求状态_待评估_optionId>" }
+            },
+            { "left": "<模块_fieldId>", "op": "EXIST" }
+          ]
+        }
+      }
+    },
+    "find_module": {
+      "type": "FindRecords",
+      "next": "notify_each_pm_owner",
+      "data": {
+        "sheetId": "<module_config_sheetId>",
+        "where": {
+          "left": "<module_config_模块名称_fieldId>",
+          "op": "EQ",
+          "right": { "ref": "$.start.<模块_fieldId>" }
+        },
+        "outputFields": ["<module_config_PM负责人_fieldId>"],
+        "terminateIfNotFound": true
+      }
+    },
+    "notify_each_pm_owner": {
+      "type": "Loop",
+      "loopEntry": "send",
+      "next": null,
+      "data": {
+        "mode": "array",
+        "items": { "ref": "$.find_module.records[*]" },
+        "maxRuns": 20
+      }
+    },
+    "send": {
+      "type": "SendMessage",
+      "next": null,
+      "data": {
+        "title": "需求受理",
+        "content": [
+          { "text": "【需求受理】『" },
+          { "ref": "$.start.<需求标题_fieldId>", "title": "需求标题" },
+          { "text": "』（模块：" },
+          { "ref": "$.start.<模块_fieldId>", "title": "模块" },
+          { "text": "）待确认是否接入。" }
+        ],
+        "to": { "users": [{ "ref": "$.notify_each_pm_owner.item.<module_config_PM负责人_fieldId>" }] },
+        "buttons": [
+          {
+            "name": "接受",
+            "color": "blue",
+            "action": {
+              "type": "updateRecord",
+              "sheetId": "<sheetId>",
+              "values": {
+                "<需求状态_fieldId>": { "option": "<需求状态_已接受_optionId>" }
+              }
+            }
+          },
+          {
+            "name": "驳回",
+            "color": "red",
+            "action": {
+              "type": "updateRecord",
+              "sheetId": "<sheetId>",
+              "values": {
+                "<需求状态_fieldId>": { "option": "<需求状态_已驳回_optionId>" }
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

package/templates/ai-native-sdlc/workflows/intake/recipes/classify-module.recipe.ts

@@ -0,0 +1,133 @@
+import {
+  tableRefConfigSchema,
+  type RecipeDefinition,
+} from "aitable-workflow-core";
+import { z } from "zod";
+import {
+  failed,
+  recordValue,
+  selectName,
+  success,
+} from "../../../lib/recipe-helpers.js";
+
+// 模块配置表只由该分类 recipe 建表与读取，配置契约不应成为跨 recipe 的共享模块。
+const moduleConfigSchema = tableRefConfigSchema({
+  label: "模块配置表",
+  description: "模块分类与 PM、Dev 负责人的公共只读配置表。",
+  access: "read",
+  ownership: "owned",
+  autoCreate: true,
+  defaultBase: "workflow.tracker.base_id",
+  setupSchema: {
+    fields: [
+      { name: "模块名称", type: "text" },
+      { name: "模块说明", type: "text" },
+      { name: "典型例子", type: "text" },
+      { name: "PM负责人", type: "user" },
+      { name: "Dev负责人", type: "user" },
+    ],
+  },
+});
+
+const recipe: RecipeDefinition = {
+  meta: {
+    id: "classify-module",
+    name: "模块判断",
+    role: "pm",
+    description: "读取模块配置表并由 PM Agent 判断模块",
+    version: "1.0.0",
+    requiresAgent: true,
+    config: z.object({
+      module_config: moduleConfigSchema,
+    }),
+  },
+  async execute(ctx) {
+    const row = await ctx.toolkit.table.readCurrentRow();
+    const demandState = selectName(row["需求状态"]);
+    if (demandState === "已接受") {
+      return success({}, "PM负责人已接受需求，继续创建变更");
+    }
+    if (demandState === "已驳回") {
+      return success({}, "PM负责人已驳回需求，交由创建变更步骤结束流程");
+    }
+    if (row["模块"]) {
+      // 等待受理用 needs_human 而非 blocked（同 create-change）：行保持 active，
+      // PM 把 需求状态 改为已接受/已驳回后下一轮自动续跑，人不需要碰 执行状态。
+      return {
+        status: "needs_human",
+        blockReason: `模块已判定为「${recordValue(row, "模块") ?? ""}」；请在需求池将 需求状态 改为「已接受」或「已驳回」以继续`,
+        output: {},
+        logs: ["等待 PM 受理门禁"],
+      };
+    }
+    const moduleTable = ctx.config.module_config as
+      | { baseId?: string; tableId?: string }
+      | undefined;
+    if (!moduleTable?.baseId || !moduleTable.tableId) {
+      return failed("模块配置表尚未完成 setup");
+    }
+    // 表内容即白名单：配置表由用户自由维护（setup 自动建表不预置行），
+    // 不在代码里硬编码候选模块名——那会让"表可自由配置"的承诺失效，
+    // 且表内填了名单外模块时查询为空，表现为无限重复"模块配置表为空"。
+    const allRows = await ctx.toolkit.table.listRecordsIn({
+      baseId: moduleTable.baseId,
+      tableId: moduleTable.tableId,
+    });
+    const modules = allRows.filter((mod) => String(mod.fields["模块名称"] ?? "").trim() !== "");
+    if (modules.length === 0) {
+      return {
+        status: "needs_human",
+        blockReason:
+          "模块配置表为空，无法判定模块；请先在「模块配置表」补充 模块名称/模块说明，或直接在需求行填写 模块 列",
+        output: {},
+        logs: ["模块配置表为空"],
+      };
+    }
+    const r = await ctx.toolkit.coding.run(
+      `## 本轮上下文
+
+### 需求
+需求标题：${recordValue(row, "需求标题")}
+需求详情：${recordValue(row, "需求详情")}
+来源类型：${selectName(row["来源类型"])}
+
+### 模块配置
+\`\`\`json
+${JSON.stringify(modules, null, 2)}
+\`\`\`
+
+## 本轮任务
+依据需求和模块配置判定唯一模块。
+
+## 输出格式
+首行只输出模块名称，第二行说明依据。`.trim(),
+    );
+    if (!r.success) return failed("模块判断 Agent 未完成");
+    // 只按首行匹配：第二行是判定依据，可能提及其他模块名导致误判。
+    const firstLine = r.response.split("\n")[0]?.trim() ?? "";
+    const selected = modules.find((mod) =>
+      firstLine.includes(String(mod.fields["模块名称"])),
+    );
+    if (!selected) {
+      // AI 的判定不丢弃：写进模块列作候选，下一轮走「模块已判定」的受理等待分支，
+      // 人只需改 需求状态（认可）或直接改 模块 列（不认可）。
+      if (firstLine) {
+        await ctx.toolkit.table.updateCurrentRow({ 模块: firstLine });
+      }
+      return {
+        status: "needs_human",
+        blockReason: firstLine
+          ? `AI 判定「${firstLine}」不在模块配置表中，已暂存为候选；认可请将 需求状态 改为「已接受」，不认可请直接修改 模块 列`
+          : "AI 未给出可辨识的模块判定；请直接填写 模块 列，或将 需求状态 改为「已接受/已驳回」以继续",
+        output: {},
+        logs: ["模块判定未匹配配置表，等待人工确认"],
+      };
+    }
+    await ctx.toolkit.table.updateCurrentRow({
+      模块: selected.fields["模块名称"],
+      需求状态: "待评估",
+    });
+    return success({}, "模块已判定，等待 PM负责人受理");
+  },
+};
+export default recipe;

package/templates/ai-native-sdlc/workflows/intake/recipes/create-change.recipe.ts

@@ -0,0 +1,94 @@
+import type { RecipeDefinition } from "aitable-workflow-core";
+import { z } from "zod";
+import { failed, selectName, success } from "../../../lib/recipe-helpers.js";
+
+// 只有创建变更需要跨 workflow 写入目标 tracker，契约随 recipe 就近声明。
+// profile 用 workflow:execution.tracker.* 引用提供实际表，不允许写死目标 tableId。
+const createChangeConfig = z.object({
+  execution_tracker: z.object({
+    base_id: z.string().min(1),
+    table_id: z.string().min(1),
+  }),
+});
+
+/** 需求标题的确定性短哈希：保证同一标题重试得到同一编号，不同标题编号不碰撞。 */
+function titleHash(title: string): string {
+  let hash = 5381;
+  for (const char of title) {
+    hash = ((hash << 5) + hash + char.charCodeAt(0)) >>> 0;
+  }
+  return hash.toString(36).padStart(7, "0").slice(-6);
+}
+
+const recipe: RecipeDefinition = {
+  meta: {
+    id: "create-change",
+    name: "创建变更",
+    role: "pm",
+    description: "仅在需求已接受后创建变更流水",
+    version: "1.0.0",
+    requiresAgent: false,
+    config: createChangeConfig,
+  },
+  async execute(ctx) {
+    const row = await ctx.toolkit.table.readCurrentRow();
+    const demandState = selectName(row["需求状态"]);
+    if (demandState === "已驳回") {
+      return success({}, "需求已驳回，不创建变更流水");
+    }
+    // 受理等待用 needs_human 而非 blocked：记录保持 执行状态=active 留在轮询集合里，
+    // PM 点接受后下一轮自读到「已接受」即建变更流水，不依赖按钮把状态从 blocked 推回。
+    // 不复用 waitForExternalProgress：它写 状态/阻塞原因/解除条件（执行 tracker 字段），
+    // 而 intake 需求池的状态字段叫 执行状态、也没有那两列。
+    if (demandState !== "已接受")
+      return {
+        status: "needs_human",
+        blockReason: "等待 PM负责人将需求状态写为已接受",
+        output: {},
+        logs: ["等待受理门禁"],
+      };
+    const target = ctx.config.execution_tracker as
+      | { base_id?: string; table_id?: string }
+      | undefined;
+    if (!target?.base_id || !target.table_id)
+      return failed("缺少 execution tracker 引用配置");
+    const title = String(row["需求标题"] ?? "").trim();
+    const slug =
+      title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 32) || "change";
+    const id = `CHG-${new Date().toISOString().slice(0, 10).replace(/-/g, "")}-${slug}-${titleHash(title)}`;
+    const existing = await ctx.toolkit.table.findRecordIn(
+      { baseId: target.base_id, tableId: target.table_id },
+      "变更编号",
+      id,
+    );
+    const recordId =
+      existing?.recordId ??
+      (
+        await ctx.toolkit.table.createRecordIn(
+          { baseId: target.base_id, tableId: target.table_id },
+          {
+            变更编号: id,
+            标题: row["需求标题"],
+            需求: row["需求标题"],
+            需求详情: row["需求详情"],
+            模块: row["模块"],
+            当前阶段: "PRD",
+            当前角色: "PM",
+            状态: "active",
+            // 人工通知在发送时按模块和阶段查询负责人，不能依赖可能为空的临时指派字段。
+            审计日志: `${id}+PRD`,
+          },
+        )
+      ).recordId;
+    await ctx.toolkit.table.updateCurrentRow({
+      产出物: `变更流水记录：${recordId}`,
+      需求状态: "开发中",
+    });
+    return success({}, "已创建或复用变更流水记录，需求进入开发中");
+  },
+};
+export default recipe;

package/templates/ai-native-sdlc/workflows/intake/recipes/mechanical-deduplicate.recipe.ts

@@ -0,0 +1,33 @@
+import type { RecipeDefinition } from "aitable-workflow-core";
+import { blocked, success } from "../../../lib/recipe-helpers.js";
+
+const recipe: RecipeDefinition = {
+  meta: {
+    id: "mechanical-deduplicate",
+    name: "机械去重",
+    role: "pm",
+    description: "按需求标题阻止重复需求",
+    version: "1.1.0",
+    requiresAgent: false,
+  },
+  async execute(ctx) {
+    const current = await ctx.toolkit.table.readCurrentRow();
+    if (current["需求状态"] === "待澄清") {
+      return blocked("疑似重复，等待人工确认");
+    }
+    const title = String(current["需求标题"] ?? "").trim();
+    if (!title) {
+      return blocked("缺少需求标题，无法执行机械去重");
+    }
+    const sameTitle = await ctx.toolkit.table.queryRows({ 需求标题: title }, 3);
+    if (sameTitle.length > 1) {
+      await ctx.toolkit.table.updateCurrentRow({
+        需求状态: "待澄清",
+        产出物: "机械去重：发现相同标题的已有需求",
+      });
+      return blocked("机械去重命中，等待人工确认");
+    }
+    return success({}, "同标题机械去重未命中");
+  },
+};
+export default recipe;

package/templates/ai-native-sdlc/workflows/intake/workflow.yml

@@ -0,0 +1,62 @@
+meta:
+  id: intake
+  name: "需求受理 / 分诊"
+  version: "1.0.0"
+  domain: ai_native_sdlc
+tracker:
+  label: "需求池"
+  # 留空 = 搭建（setup）阶段新建 Base 与表并自动回填；填了值 = 绑定已有表。
+  # 模板不预绑任何人的库；绑定作者库跑通的包不能直接当模板分发。
+  base_id: ""
+  table_id: ""
+  states:
+    {
+      initial: active,
+      active: [ active ],
+      review: blocked,
+      # 需求池走完 intake 三步 = 已建出变更流水，「已建单」是本行引擎列的终点。
+      # 需求是否上线看业务列 需求状态（发布时 review.recipe 回写「已完成」）；
+      # shipped 只属于变更流水表的终态语义，不复用到这里（避免与业务词撞车）。
+      terminal: [ 已建单, archived ],
+      blocked: blocked
+    }
+  fields: { state: "执行状态", title: "需求标题", current_step: "当前步骤", event_log: "事件日志" }
+  field_definitions:
+    - { name: "需求详情", type: richText }
+    - {
+        name: "来源类型",
+        type: singleSelect,
+        options: [ "群反馈", "Aone", "用户访谈", "竞品", "内部提议", "巡检", "线上事故" ]
+      }
+    - name: "需求状态"
+      type: singleSelect
+      options: [ "待评估", "已接受", "开发中", "已完成", "已驳回", "待澄清" ]
+    - { name: "模块", type: text }
+    - { name: "产出物", type: text }
+steps:
+  - {
+      id: mechanical_deduplicate,
+      name: "机械去重",
+      recipe: mechanical-deduplicate,
+      auto: true,
+      description: "按需求标题去重，高相似需求直接关单或阻塞。",
+    }
+  - {
+      id: classify_module,
+      name: "模块判断",
+      recipe: classify-module,
+      auto: true,
+      description: "读取模块配置表，由 PM Agent 判定唯一模块。",
+    }
+  - {
+      id: create_change,
+      name: "创建变更",
+      recipe: create-change,
+      auto: true,
+      description: "需求被接受后在 execution tracker 创建变更流水记录。",
+    }
+edges:
+  - { from: __start__, to: mechanical_deduplicate }
+  - { from: mechanical_deduplicate, to: classify_module }
+  - { from: classify_module, to: create_change }
+  - { from: create_change, to: __end__ }

package/templates/ai-native-sdlc/workspaces/dev/AGENTS.md

@@ -0,0 +1,69 @@
+# Dev 工作规程
+
+只操作每轮任务明确给出的候选仓库 worktree（绝对路径）；当前目录不是工作对象，所有文件读写、测试和 Git 命令都必须发生在给定 worktree 内。先依据已批准 PRD 与工作流提供的技术方案工件判断实际涉及的仓库；禁止为了覆盖率修改无关仓库。
+
+本文件只是角色通用规程；进入某个仓库 worktree 后，必须先读取该 worktree 根目录下的 `AGENTS.md`（若存在）并遵循其仓库级约定，仓库约定优先于本通用规程。
+
+## 外部需求链接解析
+
+技术方案或需求上下文中的外部链接必须先按链接类型只读解析：
+
+- Aone 工作项链接（`project.aone.alibaba.com/.../(bug|req|task)/<id>`）：执行 `a1 project workitem get <id> --format json`，读取 `title`、`description`、`status` 和必要字段。
+- 钉钉文档链接（`alidocs.dingtalk.com/i/nodes/<nodeId>`）：执行 `dws doc info --node '<原始URL>'` 获取元信息，再执行 `dws doc read --node '<原始URL>' --format raw`，读取返回 JSON 的 `markdown` 字段。
+
+多个链接逐个解析并保留来源 URL。CLI 未安装、未登录、无权限或读取失败时，必须记录具体原因并提问，不得猜测正文；所有调用均为只读，禁止修改外部工作项或文档。
+
+工件路径和内容以工作流提供的 `ARTIFACT_FILES` 及阶段 prompt 为准，本文件不重复维护文件名或章节。各阶段都必须按选中仓库分别记录真实产出和测试证据；不得伪造测试或 CI 通过证据。创建 CR 后持续处理新评论，只有全部 CR 实际合并后才能进入发布门禁。
+
+## 测试需求模式
+
+当需求标题以 `【测试】` 开头时，仍须真实执行计划、修改、测试、Git 提交与 CR 评审；这不是跳过 Agent 的开关。
+
+- recipe 只会提供一个候选 worktree。不得遍历、索引或调研代码库；只读取该 worktree 内本阶段所需的 `changes/<变更编号>/` 工件和评论。
+- 不修改业务功能文件。技术方案阶段只写简短技术方案工件；编码阶段在同一目录创建 `smoke.test.mjs`，使用 Node 内置 `node:test` 写一个通过用例，并运行工作流指定的真实测试命令；评审阶段更新评审工件。
+- 以最短步骤完成，不得伪造测试或 CI 通过证据；没有实际 CI 时在工件中如实写“未配置 CI”。
+
+## 提问协议（所有阶段通用）
+
+需要真人确认时不得猜测或编造，必须提问：
+
+- 每个工件末尾固定保留 `## 待确认问题`，逐项列出尚未被人工答复的问题；没有问题时该节写“无”。
+- 最终回复的末尾单独输出一行机器可读清单：`SDLC_QUESTIONS=["问题1","问题2"]`；没有问题输出 `SDLC_QUESTIONS=[]`。系统会按阶段自动分配稳定编号，无需自行编号。
+- 提问后等待人工答复，答复会在下一轮以「已消费的人工答复」给到，继续同一会话。
+## Git 提交边界
+
+不得执行 `git commit` 或 `git push`。Agent 只写入指定 worktree 并运行必要测试；工作流会在 Agent 成功后统一提交、推送和创建 CR。
+# 构建工件
+
+每个实际改动的业务仓库都必须写入 `changes/<变更编号>/03-coding.md`，并且包含：
+
+- `## 改动内容`：面向 CR 评审者的实际行为、关键文件、兼容性与风险。
+- `## 测试命令与结果`：真实执行的命令与输出摘要。
+- `## CI 证据`：已知的流水线/检查通过证据。
+
+## 表达规范
+
+- 禁止使用"应该"、"大概"、"可能"、"或许"等模糊表述
+- 每个结论必须有代码级证据（文件路径 + 行号 + 实际输出）
+- 不确定时通过 SDLC_QUESTIONS 向人工确认，不猜测
+
+## ⚖️ 证据铁律
+
+**没有当场跑过验证命令并看到输出 → 不能声称通过。**
+
+### 操作规程
+1. 识别验证命令（测试/类型检查/构建）
+2. 运行完整命令（不是部分）
+3. 阅读完整输出（不是尾部）
+4. 确认输出支持你的声明
+5. 只有此时才能声称"通过"
+
+### 🚩 红旗信号
+- 使用"应该"、"大概"、"可能" → 还没验证，继续跑命令
+- 验证前说"太好了"、"搞定了" → 停下来，先跑验证
+- 准备提交但没跑测试 → 不允许
+
+### 工件必须包含的证据
+- ✅ 测试命令的**实际运行输出**
+- ✅ 类型检查命令的**实际运行输出**
+- ✅ `git diff HEAD~1` 的**实际输出**

package/templates/ai-native-sdlc/workspaces/pm/AGENTS.md

@@ -0,0 +1,48 @@
+# PM 工作规程
+
+负责需求分诊、意图、PRD 与前序工件审阅。所有结论必须写入当前变更的 Git 工件或 AI 表格字段，不能只留在对话中。
+
+每轮任务会给出本次变更的 worktree 绝对路径；当前目录不是工作对象，所有文件读写和命令都必须发生在给定的 worktree 路径内。将意图与 PRD 写入 PM worktree 的 `changes/<变更编号>/`。
+
+本文件只是角色通用规程；进入某个仓库 worktree 后，必须先读取该 worktree 根目录下的 `AGENTS.md`（若存在）并遵循其仓库级约定，仓库约定优先于本通用规程。
+
+## 业务代码上下文
+
+当 PRD prompt 提供业务代码仓库 URL 时，先按可用的只读能力阅读其 `master` 当前逻辑，再撰写 PRD。
+业务代码仓库只用于理解现状，不是 PM 工件的写入目标：不得为它们创建变更 worktree、分支、工件、commit 或 push。
+
+## 外部需求链接解析
+
+需求标题或详情中的外部链接必须先按链接类型只读解析，再用于 PRD：
+
+- Aone 工作项链接（`project.aone.alibaba.com/.../(bug|req|task)/<id>`）：执行 `a1 project workitem get <id> --format json`。读取返回的 `title`、`description`、`status` 和需要的字段；URL 中的 project id 仅用于核对归属，不替代 workitem id。
+- 钉钉文档链接（`alidocs.dingtalk.com/i/nodes/<nodeId>`）：先执行 `dws doc info --node '<原始URL>'`，再执行 `dws doc read --node '<原始URL>' --format raw`，从返回 JSON 的 `markdown` 字段读取正文。
+
+多个链接逐个解析并保留来源 URL。CLI 未安装、未登录、无权限或读取失败时，必须把具体失败原因写入「待确认问题」，不得根据链接标题猜测正文；所有调用均为只读，禁止修改 Aone 工作项或钉钉文档。
+
+## 测试需求模式
+
+当需求标题以 `【测试】` 开头时，仍须真实生成本阶段工件并走 Git/CR 流程；这不是跳过 Agent 的开关。
+
+- 不读取、遍历、索引或调研任何业务代码仓库；只读取当前 PM worktree 与本轮明确给出的工件、评论。
+- 立即在 `changes/<变更编号>/01-prd.md` 写入简短 PRD：目标是验证此 SDLC 流程；验收标准是工件、测试、commit 和 CR 均真实完成；依赖写“无”；`## 待确认问题` 写“无”。不要为业务功能补充背景、设计或调研。
+- 以最短步骤完成，不能因测试内容不重要而跳过文件写入、提交或评论处理。
+
+## 提问协议（所有阶段通用）
+
+需要真人确认时不得猜测或编造，必须提问：
+
+- 每个工件末尾固定保留 `## 待确认问题`，逐项列出尚未被人工答复的问题；没有问题时该节写“无”。
+- 最终回复的末尾单独输出一行机器可读清单：`SDLC_QUESTIONS=["问题1","问题2"]`；没有问题输出 `SDLC_QUESTIONS=[]`。系统会按阶段自动分配稳定编号，无需自行编号。
+- 提问后等待人工答复，答复会在下一轮以「已消费的人工答复」给到，继续同一会话。
+
+PRD 需形成可评审工件，并在 CR 评论出现后逐项修复、更新工件和验证结果。只以实际 CR 合并作为进入实现计划的事实。
+## Git 提交边界
+
+不得执行 `git commit` 或 `git push`。Agent 只写入指定 worktree 并运行必要测试；工作流会在 Agent 成功后统一提交、推送和创建 CR。
+
+## 表达规范
+
+- 禁止使用"应该"、"大概"、"可能"、"或许"等模糊表述
+- 每个结论必须有代码级证据（文件路径 + 行号 + 实际输出）
+- 不确定时通过 SDLC_QUESTIONS 向人工确认，不猜测