@pylonts/ai-executor

任务卡（Task Card）基础设施——为多 AI 并行执行生成任务卡（markdown 提示词）。

不是 AI 执行器：不调 LLM、不生成代码、不校验产物。事实段机器填充，业务段留给 AI 操刀。

规格见 docs/ai-executor-spec.md。

并行拓扑

Phase 1b   DTO 按表并行（CRUD 一个 AI 一张卡）
Phase 1c   pylonts gen dto + pylonts gen api 汇合（机器）
Phase 2    执行按 controller 并行（一个 controller = 后端 AI + 前端 AI，页内串行页间并行）

命令

在项目根目录运行（需要 schema/ 与 api-admin/）：

# DTO 任务卡：按表
pylon-ai-executor gen dto --table=bd --out=.okapi/docs/tasks/bd.dto.md

# 页面任务卡：按 controller
pylon-ai-executor gen page --controller=BdController --page=admin/bd-list --out=.okapi/docs/tasks/bd-list.page.md

• gen dto 事实段从 schema/{table}.table.ts 提取（列/类型/必填/枚举/语义/说明/paginated/actor）
• gen page 事实段从 modules/*/controller/{Name}Controller.ts 扫描（RPC 前缀 + 方法 + 鉴权 + Body/Response 类型及 import 来源）
• 模板见 templates/（DTO 卡 / 页面卡，五段结构：任务边界 / 事实来源 / 工具链 / 规范约束 / 验收标准）
• 业务段（任务边界、分组归属）由调度人/AI 精修，命令不做业务判断

开发

npm run typecheck
npm run cli -- gen dto --table=<name>

依赖

• 运行时：ts-morph（controller 扫描）
• peer：tsx（CLI 经 tsx 运行 TS 入口）