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

package/templates/ai-native-sdlc/workflows/execution/recipes/coding.recipe.ts

@@ -0,0 +1,161 @@
+import type { RecipeDefinition } from "aitable-workflow-core";
+import { readFile } from "node:fs/promises";
+import { devStageConfig } from "../../../lib/recipe-config.js";
+import { artifactAbsPath, artifactName, artifactPath, resolveWorktreeDir } from "../../../lib/artifacts.js";
+import {
+  agentQuestions,
+  appendArtifact,
+  appendStageTransition,
+  blockExecution,
+  blocked,
+  changeId,
+  changeTitle,
+  commitOptions,
+  consumeAnswersOrBlock,
+  failed,
+  handleCodingFailure,
+  hasStageTransition,
+  isTestDemand,
+  isCurrentRecipe,
+  persistCodingSession,
+  questionsText,
+  recordValue,
+  repositoryUrl,
+  repoPathFromUrl,
+  formatCrEntries,
+  requireRepositories,
+  sessionMap,
+  success,
+  testDemandInstruction,
+  worktreeOptions,
+  buildChangeDetails,
+} from "../../../lib/recipe-helpers.js";
+
+const recipe: RecipeDefinition = {
+  meta: {
+    id: "coding",
+    name: "编码",
+    role: "dev",
+    description: "Dev 实施、运行真实测试并提交编码工件",
+    version: "1.0.0",
+    requiresAgent: true,
+    config: devStageConfig,
+  },
+  async execute(ctx) {
+    const row = await ctx.toolkit.table.readCurrentRow();
+    const id = changeId(row);
+    const configuredRepos = requireRepositories(ctx, "dev_repositories");
+    const repos = isTestDemand(row) ? configuredRepos.slice(0, 1) : configuredRepos;
+    if (!id || !repos.length)
+      return failed("编码阶段缺少变更编号或 Dev 候选仓库配置");
+    if (!isCurrentRecipe(row, ctx.stepId)) {
+      return blocked("当前步骤与执行 recipe 不一致，拒绝重复执行编码");
+    }
+    if (hasStageTransition(row["审计日志"], id, "评审")) {
+      return success({}, "恢复：编码已完成但步骤指针尚未推进");
+    }
+    const resumed = await consumeAnswersOrBlock(ctx, row);
+    if (resumed.blocked) return resumed.blocked;
+    const worktrees = await Promise.all(
+      repos.map((repo) =>
+        ctx.toolkit.git.ensureWorktree(repo, id, id, worktreeOptions(repo)),
+      ),
+    );
+    const candidateWorktrees = worktrees
+      .map((worktree, index) => `- ${repositoryUrl(repos[index]!)}: ${resolveWorktreeDir(ctx.configDir, worktree.dir)}`)
+      .join("\n");
+    const result = await ctx.toolkit.coding.run(
+      `## 候选业务 worktree
+${candidateWorktrees}
+公共父目录不是 Git 仓库；所有文件只能写入具体仓库 worktree。
+进入某仓库前先读取其根目录 AGENTS.md（若存在），并遵循其约定。
+
+${testDemandInstruction(row)}
+
+## 已消费的人工答复
+${resumed.answers}
+
+## 需求
+标题：${recordValue(row, "需求")}
+详情：${recordValue(row, "需求详情")}
+
+## 本轮任务
+先在候选 worktree 中读取 ${artifactPath("spec", id)}。
+仅实现技术方案选中的仓库并运行真实测试。
+在每个选中仓库的 ${artifactPath("coding", id)} 写入以下章节。具体行为、关键文件与风险说明写在「改动内容」章节正文中：
+## 改动内容
+## 测试命令与结果
+## CI 证据`.trim(),
+      {
+        sessionId: sessionMap(row["Agent会话ID"])["coding:dev"],
+      },
+    );
+    if (!result.success) {
+      return handleCodingFailure(
+        ctx,
+        row,
+        "coding",
+        "coding:dev",
+        result,
+        "编码 Agent 未完成",
+      );
+    }
+    const agentSession = await persistCodingSession(ctx, row, "coding:dev", result);
+    const commits = await Promise.all(
+      worktrees.map((worktree) =>
+        ctx.toolkit.git.commit(worktree.dir, `${id}: coding`, commitOptions(row)),
+      ),
+    );
+    const questions = agentQuestions(result.response, "coding");
+    const persisted = {
+      产出物: appendArtifact(
+        row["产出物"],
+        `${artifactName("coding")}；commit=${commits.some((commit) => commit.committed) ? `${id}: coding` : "已存在"}`,
+      ),
+      Agent会话ID: agentSession,
+    };
+    if (questions.length) {
+      return blockExecution(
+        ctx,
+        "编码存在待确认问题",
+        "在人工答复中按问题编号逐项回答后自动续跑",
+        questionsText(questions),
+        persisted,
+      );
+    }
+    const diffs = await Promise.all(worktrees.map((worktree) => ctx.toolkit.git.diff(worktree.dir, "origin/master")));
+    const changed = worktrees.filter((_, index) => diffs[index]!.files.length > 0);
+    if (!changed.length) return blocked("编码完成后没有相对 master 的已提交改动，无法创建 CR");
+    const entries = await Promise.all(changed.map(async (worktree) => {
+      const repository = repos[worktrees.indexOf(worktree)]!;
+      const repoUrl = repositoryUrl(repository);
+      let buildMarkdown: string;
+      try {
+        buildMarkdown = await readFile(artifactAbsPath("coding", resolveWorktreeDir(ctx.configDir, worktree.dir), id), "utf8");
+      } catch {
+        throw new Error(`编码工件缺失：${artifactPath("coding", id)}`);
+      }
+      const details = buildChangeDetails(buildMarkdown);
+      if (!details) throw new Error(`编码工件缺少非空「## 改动内容」：${artifactPath("coding", id)}`);
+      await ctx.toolkit.git.push(worktree.dir, id);
+      const mr = await ctx.toolkit.codeReview.createMR(
+        repoPathFromUrl(repoUrl), id, "master", `${changeTitle(row, id)} · 编码`,
+        `请评审 ${artifactPath("coding", id)} 及编码改动。\n\n## 改动详情\n${details}`,
+      );
+      return { repoUrl, mrId: mr.mrId, mrUrl: mr.mrUrl };
+    }));
+    await ctx.toolkit.table.updateCurrentRow({
+      当前阶段: "评审",
+      当前角色: "Dev",
+      状态: "active",
+      审计日志: appendStageTransition(row["审计日志"], id, "评审"),
+      AI问题: "",
+      阻塞原因: "",
+      解除条件: "",
+      当前CR链接: formatCrEntries(entries),
+      ...persisted,
+    });
+    return success({}, "编码工件已提交并创建代码 CR");
+  },
+};
+export default recipe;

package/templates/ai-native-sdlc/workflows/execution/recipes/prd-review.recipe.ts

@@ -0,0 +1,200 @@
+import type { RecipeDefinition } from "aitable-workflow-core";
+import { pmStageConfig } from "../../../lib/recipe-config.js";
+import {
+  artifactAbsPath,
+  artifactName,
+  resolveWorktreeDir,
+} from "../../../lib/artifacts.js";
+import {
+  agentQuestions,
+  appendArtifact,
+  appendHandledComments,
+  appendStageTransition,
+  blockExecution,
+  blocked,
+  changeId,
+  commentRepairNotice,
+  commitOptions,
+  consumeAnswersOrBlock,
+  crId,
+  crEntries,
+  failed,
+  handleCodingFailure,
+  hasStageTransition,
+  isCurrentRecipe,
+  persistCodingSession,
+  questionsText,
+  repoPathFromUrl,
+  repositoryUrl,
+  requireRepository,
+  sessionMap,
+  success,
+  testDemandInstruction,
+  unhandledComments,
+  waitForExternalProgress,
+  worktreeOptions,
+  MAX_REVIEW_ROUNDS,
+  parseReviewRound,
+} from "../../../lib/recipe-helpers.js";
+
+const recipe: RecipeDefinition = {
+  meta: {
+    id: "prd-review",
+    name: "PRD 评审",
+    role: "reviewer",
+    description: "PM 处理 PRD CR 评论并确认实际合并",
+    version: "1.0.0",
+    requiresAgent: true,
+    config: pmStageConfig,
+  },
+  async execute(ctx) {
+    const row = await ctx.toolkit.table.readCurrentRow();
+    const id = changeId(row);
+    const pmRepository = requireRepository(ctx, "pm_repository");
+    if (!id || !pmRepository) return failed("PRD 评审缺少变更编号或 PM 仓库配置");
+    const repoUrl = repositoryUrl(pmRepository);
+    if (!isCurrentRecipe(row, ctx.stepId)) {
+      return blocked("当前步骤与执行 recipe 不一致，拒绝执行 PRD 评审");
+    }
+    if (hasStageTransition(row["审计日志"], id, "技术方案")) {
+      return success({}, "恢复：PRD 已合并但步骤指针尚未推进");
+    }
+    // 有界重试：超过最大轮次则升级人工（放在恢复检查之后，避免误阻塞已完成阶段）
+    const currentRound = parseReviewRound(row);
+    if (currentRound > MAX_REVIEW_ROUNDS) {
+      return blocked(`PRD 评审修复已超过 ${MAX_REVIEW_ROUNDS} 轮，请人工介入`);
+    }
+    const mrId = crId(row["当前CR链接"]);
+    if (!mrId) return failed("PRD 评审缺少当前 CR 链接");
+    const resumed = await consumeAnswersOrBlock(ctx, row);
+    if (resumed.blocked) return resumed.blocked;
+    
+    const repoPath = repoPathFromUrl(repoUrl);
+    const comments = await ctx.toolkit.codeReview.listUnresolvedComments(
+      mrId,
+      repoPath,
+    );
+    const pendingComments = unhandledComments(row["产出物"], "prd", mrId, comments);
+    if (pendingComments.length) {
+      const worktree = await ctx.toolkit.git.ensureWorktree(
+        pmRepository,
+        id,
+        id,
+        worktreeOptions(pmRepository),
+      );
+      const repair = await ctx.toolkit.coding.run(
+        `## 工作目录
+所有文件读写和命令只在此变更 worktree 内进行：${resolveWorktreeDir(ctx.configDir, worktree.dir)}
+先读取该 worktree 根目录下的 AGENTS.md（若存在），并遵循其仓库约定。
+
+${testDemandInstruction(row)}
+
+## 未解决评论
+\`\`\`json
+${JSON.stringify(pendingComments, null, 2)}
+\`\`\`
+
+## 已消费的人工答复
+${resumed.answers}
+
+## 本轮任务
+逐项修复评论。
+更新 ${artifactAbsPath("prd", resolveWorktreeDir(ctx.configDir, worktree.dir), id)}。
+运行适用校验。`.trim(),
+          {
+            sessionId: sessionMap(row["Agent会话ID"])["prd:pm"],
+          },
+      );
+      if (!repair.success) {
+        return handleCodingFailure(
+          ctx,
+          row,
+          "prd",
+          "prd:pm",
+          repair,
+          "PRD 评论修复 Agent 未完成",
+        );
+      }
+      const agentSession = await persistCodingSession(ctx, row, "prd:pm", repair);
+      const commit = await ctx.toolkit.git.commit(
+        worktree.dir,
+        `${id}: prd review fixes`,
+        commitOptions(row),
+      );
+      const persisted = {
+        Agent会话ID: agentSession,
+        审查轮次: currentRound + 1,
+        产出物: appendHandledComments(
+          appendArtifact(
+            row["产出物"],
+            `${artifactName("prd")}；评论修复commit=${commit.committed ? `${id}: prd review fixes` : "已存在"}`,
+          ),
+          "prd",
+          mrId,
+          pendingComments,
+        ),
+      };
+      const questions = agentQuestions(repair.response, "prd");
+      if (questions.length) {
+        return blockExecution(
+          ctx,
+          "PRD 评论修复仍有待确认问题",
+          "在人工答复中按问题编号逐项回答后自动续跑",
+          questionsText(questions),
+          persisted,
+        );
+      }
+      await ctx.toolkit.git.push(worktree.dir, id);
+      const crEntry = crEntries(row["当前CR链接"]).find((entry) => entry.mrId === mrId);
+      return waitForExternalProgress(
+        ctx,
+        row,
+        "PRD 评论已修复，等待复审",
+        "等待评审者关闭评论或提出新评论",
+        {
+          评审进展: commentRepairNotice([{
+            repoUrl,
+            mrUrl: crEntry?.mrUrl ?? String(row["当前CR链接"] ?? ""),
+            commentCount: pendingComments.length,
+          }]),
+          ...persisted,
+        },
+      );
+    }
+    const [ready, merged] = await Promise.all([
+      ctx.toolkit.codeReview.isReadyToMerge(mrId, repoPath),
+      ctx.toolkit.codeReview.isMerged(mrId, repoPath),
+    ]);
+    if (merged) {
+      await ctx.toolkit.table.updateCurrentRow({
+      当前阶段: "技术方案",
+        当前角色: "Dev",
+        状态: "active",
+        当前CR链接: "",
+        评审进展: "",
+        审计日志: appendStageTransition(row["审计日志"], id, "技术方案"),
+        AI问题: "",
+        阻塞原因: "",
+        解除条件: "",
+      });
+      return success({}, "PRD CR 已合并，进入技术方案");
+    }
+    if (!ready || comments.length) {
+      return waitForExternalProgress(
+        ctx,
+        row,
+        "PRD CR 尚未通过或仍有未解决评论",
+        "等待审核通过，或等待新评论被自动修复",
+        { 当前角色: "PM" },
+      );
+    }
+    return waitForExternalProgress(
+      ctx,
+      row,
+      "PRD CR 已可合并，等待其真正合并",
+      "请在 GitLab 合并 PRD CR；合并事实将自动进入技术方案",
+      { 当前角色: "PM" },
+    );
+  },
+};
+export default recipe;

package/templates/ai-native-sdlc/workflows/execution/recipes/prd.recipe.ts

@@ -0,0 +1,163 @@
+import type { RecipeDefinition } from "aitable-workflow-core";
+import { prdStageConfig } from "../../../lib/recipe-config.js";
+import {
+  artifactAbsPath,
+  artifactName,
+  artifactPath,
+  ensureArtifactManifest,
+  resolveWorktreeDir,
+} from "../../../lib/artifacts.js";
+import {
+  agentQuestions,
+  appendArtifact,
+  appendStageTransition,
+  blockExecution,
+  blocked,
+  changeId,
+  changeTitle,
+  consumeAnswersOrBlock,
+  failed,
+  handleCodingFailure,
+  hasStageTransition,
+  isTestDemand,
+  isCurrentRecipe,
+  persistCodingSession,
+  questionsText,
+  recordValue,
+  repositoryUrl,
+  repoPathFromUrl,
+  requireRepositories,
+  requireRepository,
+  sessionMap,
+  success,
+  testDemandInstruction,
+  worktreeOptions,
+} from "../../../lib/recipe-helpers.js";
+
+const recipe: RecipeDefinition = {
+  meta: {
+    id: "prd",
+    name: "PRD",
+    role: "pm",
+    description: "PM 产出 PRD 工件，无未解问题后创建待评审 CR",
+    version: "1.1.0",
+    requiresAgent: true,
+    config: prdStageConfig,
+  },
+  async execute(ctx) {
+    const row = await ctx.toolkit.table.readCurrentRow();
+    const id = changeId(row);
+    const pmRepository = requireRepository(ctx, "pm_repository");
+    const businessRepositories = requireRepositories(ctx, "business_repositories");
+    const testing = isTestDemand(row);
+    if (!id || !pmRepository || (!testing && !businessRepositories.length)) {
+      return failed("PRD 阶段缺少变更编号、PM 仓库或业务代码仓库配置");
+    }
+    const repoUrl = repositoryUrl(pmRepository);
+    if (!isCurrentRecipe(row, ctx.stepId)) {
+      return blocked("当前步骤与执行 recipe 不一致，拒绝生成 PRD");
+    }
+    if (hasStageTransition(row["审计日志"], id, "PRD 评审")) {
+      return success({}, "恢复：PRD CR 已创建但步骤指针尚未推进");
+    }
+    const resumed = await consumeAnswersOrBlock(ctx, row);
+    if (resumed.blocked) return resumed.blocked;
+    const worktree = await ctx.toolkit.git.ensureWorktree(
+      repositoryUrl(pmRepository),
+      id,
+      id,
+      worktreeOptions(pmRepository),
+    );
+    const businessContext = testing
+      ? "## 测试需求\n不读取业务代码仓库；直接按工作目录 AGENTS.md 的测试模式生成最小 PRD。"
+      : `## 业务代码仓库（只读上下文）
+先按可用的只读能力阅读以下仓库 master 的当前逻辑，再撰写 PRD：
+${businessRepositories.map((repository) => `- ${repositoryUrl(repository)}`).join("\n")}
+进入某仓库前先读取其根目录 AGENTS.md（若存在），并遵循其约定，不要为这些业务仓库创建 worktree、分支、工件、commit 或 push。`;
+    const result = await ctx.toolkit.coding.run(
+      `## 本轮上下文
+
+### PM 工件工作目录
+${resolveWorktreeDir(ctx.configDir, worktree.dir)}
+
+${businessContext}
+
+### 需求
+需求：${recordValue(row, "需求")}
+需求详情：${recordValue(row, "需求详情")}
+模块：${recordValue(row, "模块")}
+
+${testDemandInstruction(row)}
+
+## 已消费的人工答复
+${resumed.answers}
+
+## 本轮任务
+创建或更新 ${artifactAbsPath("prd", resolveWorktreeDir(ctx.configDir, worktree.dir), id)}。
+PRD 必须写明需求、验收标准和依赖。
+
+`.trim(),
+      {
+        sessionId: sessionMap(row["Agent会话ID"])["prd:pm"],
+      },
+    );
+    if (!result.success) {
+      return handleCodingFailure(
+        ctx,
+        row,
+        "prd",
+        "prd:pm",
+        result,
+        "PRD Agent 未完成",
+      );
+    }
+    const agentSession = await persistCodingSession(ctx, row, "prd:pm", result);
+    // 登记必须先于 commit：manifest 与工件同一次提交，下游 push 后即可读。
+    ensureArtifactManifest(resolveWorktreeDir(ctx.configDir, worktree.dir), id, "prd");
+    const commit = await ctx.toolkit.git.commit(worktree.dir, `${id}: prd`);
+    const questions = agentQuestions(result.response, "prd");
+    const persisted = {
+      当前阶段: "PRD",
+      当前角色: "PM",
+      产出物: appendArtifact(
+        row["产出物"],
+        `${artifactName("prd")}；commit=${commit.committed ? `${id}: prd` : "已存在"}`,
+      ),
+      Agent会话ID: agentSession,
+    };
+    if (questions.length) {
+      return blockExecution(
+        ctx,
+        "PRD 存在待确认问题",
+        "在人工答复中按问题编号逐项回答后自动续跑",
+        questionsText(questions),
+        persisted,
+      );
+    }
+    await ctx.toolkit.git.push(worktree.dir, id);
+    const mr = await ctx.toolkit.codeReview.createMR(
+      repoPathFromUrl(repoUrl),
+      id,
+      "master",
+      `${changeTitle(row, id)} · PRD`,
+      `请评审 ${artifactPath("prd", id)}。`,
+    );
+    await ctx.toolkit.table.updateCurrentRow({
+      当前阶段: "PRD 评审",
+      当前角色: "PM",
+      状态: "active",
+      当前CR链接: mr.mrUrl,
+      审计日志: appendStageTransition(row["审计日志"], id, "PRD 评审"),
+      AI问题: "",
+      阻塞原因: "",
+      解除条件: "",
+      产出物: appendArtifact(
+        persisted.产出物,
+        `${artifactName("prd")}；CR(!${mr.mrId})=${mr.mrUrl}`,
+      ),
+      Agent会话ID: persisted.Agent会话ID,
+    });
+    return success({}, "PRD 工件已提交，进入 PRD 评审");
+  },
+};
+export default recipe;