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

package/templates/ai-native-sdlc/profile/profile.yml

@@ -0,0 +1,115 @@
+# Profile v2 —— 空脚手架
+#
+# 场景配置的唯一事实源，双轴并列：
+#   roles.*     = 身份轴（这个角色是谁、能做什么、记得什么、受什么约束）
+#   workflows.* = 部署轴（toolkit_config / event_sources / steps）
+#
+# 两轴都由「设计」一步按需求生成。**别把部署配置写进 roles**：
+# triggers / event_sources / conditions / 工具白名单 / 数据边界都属于 workflows 段。
+#
+# 引用语法（只有整值 ref 生效，嵌在字符串里不会被解析）：
+#   ${roles.<path>}     加载期展开，来源是本文件
+#   ${env.X}            运行期活读 .env / process.env
+#   ${config.X}         运行期活读 aitable-workflow.config.yml 的点路径
+#   ${globalVar.X}      运行期活读 recipe 发布态；**首轮发布前为空，消费方必须能降级**
+
+schema_version: 2
+
+meta:
+  label: "AI Native SDLC 双数字员工协作台"
+  description: "PM 与 Dev 在同一条变更流水中接力，Git 工件和 CR 是阶段门禁。"
+
+roles:
+  pm:
+    name: PM
+    persona: "你是负责需求分诊、意图澄清、PRD 设计与前序工件审阅的 PM。"
+    guardrails:
+      - id: durable-output
+        rule: "结论必须写入 Git 工件或 AI 表格字段，不能只留在对话中。"
+        severity: critical
+  dev:
+    name: Dev
+    persona: "你是负责技术方案、编码实现与代码评审处理的 Dev。"
+    guardrails:
+      - id: allowed-repositories
+        rule: "只能操作 workflow 部署配置中的 Dev 仓库白名单。"
+        severity: critical
+  reviewer:
+    name: Reviewer
+    persona: "你是独立的代码审查者，负责以对抗性思维审查 PRD、技术方案和代码实现。你的职责是找出缺陷和风险，而不是确认正确性。"
+    guardrails:
+      - id: adversarial-mindset
+        rule: "假设被审查对象有缺陷，你的任务是找到它。对每条评论，先理解评审者的意图，再决定修复方案；如果认为评论有误，给出有理有据的反驳而非盲目修改。"
+        severity: critical
+      - id: evidence-based
+        rule: "每个结论必须有代码级证据（文件路径 + 行号 + 实际输出）。禁止使用模糊表述。"
+        severity: critical
+
+workflows:
+  intake:
+    toolkit_config:
+      messaging: { robot_creds: "${env.DINGTALK_ROBOTS?}" }
+    steps:
+      classify_module:
+        module_config:
+          mode: owned
+          # 留空 + autoCreate：setup 在项目的 Base 内新建模块配置表并回填。
+          baseId: ""
+          tableId: ""
+      create_change:
+        execution_tracker:
+          base_id: { ref: "workflow:execution.tracker.base_id" }
+          table_id: { ref: "workflow:execution.tracker.table_id" }
+  execution:
+    # YAML anchor 是作者侧的单一仓库定义；alias 在 profile loader 前展开，steps 只消费完整结构。
+    repositories:
+      pm_artifacts: &pm_artifacts
+        url: "git@gitlab.alibaba-inc.com:xule-test/ai-staff.git"
+        default_branch: origin/master
+      we_notable: &we_notable
+        url: "git@gitlab.alibaba-inc.com:alidocs/we-notable.git"
+        default_branch: origin/master
+        commands:
+          - bin: pnpm
+            args: ["install", "--frozen-lockfile"]
+            timeout_ms: 1200000
+      lippi_notable: &lippi_notable
+        url: "git@gitlab.alibaba-inc.com:alidocs/lippi-doc-notable.git"
+        default_branch: origin/master
+    toolkit_config:
+      messaging: { robot_creds: "${env.DINGTALK_ROBOTS?}" }
+      git:
+        default_branch: origin/master
+    steps:
+      prd:
+        pm_repository: *pm_artifacts
+        business_repositories: [*we_notable, *lippi_notable]
+      prd_review:
+        pm_repository: *pm_artifacts
+      spec:
+        pm_repository: *pm_artifacts
+        dev_repositories: [*we_notable, *lippi_notable]
+      spec_review:
+        dev_repositories: [*we_notable, *lippi_notable]
+      coding:
+        dev_repositories: [*we_notable, *lippi_notable]
+      review:
+        dev_repositories: [*we_notable, *lippi_notable]
+        intake_tracker:
+          base_id: { ref: "workflow:intake.tracker.base_id" }
+          table_id: { ref: "workflow:intake.tracker.table_id" }
+
+# roles:
+#   <role-id>:              # ← 设计阶段填写，键名即 role id
+#     name: ""
+#     persona:
+#       file: prompts/<role-id>.md
+#     knowledge_scope:
+#       kb_collections: []
+#     guardrails: []
+
+# workflows:
+#   <workflow-id>:          # ← 设计阶段填写，键名必须与 workflow.yml 的 meta.id 一致
+#     toolkit_config: {}
+#     event_sources: {}
+#     steps: {}

package/templates/ai-native-sdlc/setup/module-config.seed.json

@@ -0,0 +1,37 @@
+[
+  {
+    "模块名称": "数据源与同步",
+    "模块说明": "接三方数据、导入导出、iPaaS 连接器、同步链路",
+    "典型例子": "从 MySQL 定时同步；大 XLSX 导入失败"
+  },
+  {
+    "模块名称": "插件与扩展",
+    "模块说明": "字段装饰器、边栏插件、脚本、酷应用、addon",
+    "典型例子": "AI 字段插件不更新；沙箱通信报错"
+  },
+  {
+    "模块名称": "AI 能力与知识",
+    "模块说明": "AI 字段、LLM 调用、知识库编译回流、RAG 问答",
+    "典型例子": "AI 生成列不准；知识回流没闭环"
+  },
+  {
+    "模块名称": "前端与交互",
+    "模块说明": "视图与表格渲染、移动端、交互体验、设计还原",
+    "典型例子": "移动端列宽；看板拖拽卡顿"
+  },
+  {
+    "模块名称": "协作与权限",
+    "模块说明": "分享、协作者权限、评论、可见性",
+    "典型例子": "外部成员只读；评论 @ 不到人"
+  },
+  {
+    "模块名称": "平台与运维",
+    "模块说明": "OpenAPI、HSF、性能、稳定性、监控巡检、部署",
+    "典型例子": "scanSheetRecord 超时；OpenAPI 限流"
+  },
+  {
+    "模块名称": "其他·未分模块",
+    "模块说明": "判不准、跨多模块、全新方向",
+    "典型例子": "先挂这里，后续再拆"
+  }
+]

package/templates/ai-native-sdlc/test/artifacts.test.ts

@@ -0,0 +1,72 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import {
+  artifactAbsPath,
+  artifactName,
+  artifactPath,
+  changeDir,
+  stageBranchName,
+} from "../lib/artifacts.js";
+
+test("变更工件目录与命名集中定义，供各阶段 recipe 复用", () => {
+  assert.equal(changeDir("CHG-1"), "changes/CHG-1");
+
+  assert.equal(artifactName("prd"), "01-prd.md");
+  assert.equal(artifactName("spec"), "02-spec.md");
+  assert.equal(artifactName("coding"), "03-coding.md");
+  assert.equal(artifactName("review"), "04-review.md");
+
+  assert.equal(artifactPath("prd", "CHG-1"), "changes/CHG-1/01-prd.md");
+  assert.equal(artifactPath("review", "CHG-1"), "changes/CHG-1/04-review.md");
+
+  assert.equal(
+    artifactAbsPath("coding", "/tmp/wt", "CHG-1"),
+    "/tmp/wt/changes/CHG-1/03-coding.md",
+  );
+  assert.equal(stageBranchName("spec", "CHG-1"), "CHG-1-2-spec");
+});
+
+test("各阶段 recipe 不再硬编码工件路径，只从 artifacts 模块取名", () => {
+  const recipes = [
+    "prd",
+    "prd-review",
+    "spec",
+    "coding",
+    "review",
+  ] as const;
+  for (const name of recipes) {
+    const source = readFileSync(
+      resolve(`workflows/execution/recipes/${name}.recipe.ts`),
+      "utf8",
+    );
+    assert.ok(
+      !/changes\/\$\{id\}|0\d-(prd|spec|coding|review)\.md/.test(source),
+      `${name}.recipe.ts 仍硬编码了工件路径`,
+    );
+  }
+});
+
+test("coding 工件使用解析器约定的精确改动内容标题", () => {
+  const source = readFileSync(
+    resolve("workflows/execution/recipes/coding.recipe.ts"),
+    "utf8",
+  );
+  assert.match(source, /写入以下章节[\s\S]*?\n## 改动内容\n/);
+  assert.doesNotMatch(source, /## 改动内容（面向评审者说明实际行为、关键文件与风险）/);
+});
+
+test("PM 与 Dev 规程声明 Aone 和钉钉文档链接的只读解析方式", () => {
+  for (const file of ["workspaces/pm/AGENTS.md", "workspaces/dev/AGENTS.md"]) {
+    const source = readFileSync(resolve(file), "utf8");
+    assert.match(source, /a1 project workitem get <id> --format json/);
+    assert.match(source, /dws doc info --node/);
+    assert.match(source, /dws doc read --node/);
+    assert.match(source, /只读/);
+  }
+  const profile = readFileSync(resolve("profile/profile.yml"), "utf8");
+  assert.match(profile, /pm:\n\s+name: PM\n\s+persona: "你是负责需求分诊/);
+  assert.match(profile, /dev:\n\s+name: Dev\n\s+persona: "你是负责技术方案/);
+  assert.doesNotMatch(profile, /prompts\/(pm|dev)\.md/);
+});