SuperAPI AI 工具集

factory-intent

智能体与模型

查看项目

更新于 10-28 22:56

技能介绍

用途 factory-intent 用于编排一次“意图生命周期”:从一份 Mission Brief 同时维护产品与架构两条轨道,产出一致的 PRD.md 与 AD.md。它协调产品侧技能(product-init、product-specify、product-clarify、product-implement、product-analyze)与架构侧技能(architect-init、architect-specify、architect-clarify、architect-implement、architect-analyze),作为 Kind-A DAG 编排器运行,对齐 factory-mission/references/executor.md 中的共享执行器契约。它取代原先的两个孪生编排器,合并为一个双轨 DAG。

适用场景 希望从单一意图端到端捕获产品需求与架构决策,且每条轨道在自己的门禁上签署确认;希望获得引导式、带接受门禁、可验证且带恢复检查点的定义流程。不适用于软件实施任务执行(应使用 factory-mission),也不适用于已过意图阶段的单轨后续工作(应直接调用对应轨道技能)。

生命周期 DAG 默认 greenfield 路线:product-specify / architect-specify 生成草稿,分别写入 .adlc/drafts/pdr/ 与 .adlc/drafts/adr/;product-clarify / architect-clarify 做质量检查,各轨道在自己的门禁上标记草稿被接受;gate-product-decisions 与 gate-architecture-decisions 为两个独立、范围绑定的人工门禁,任一轨道门禁阻塞不影响另一轨道继续起草,只有联合实施等待两者都通过;build-and-verify 先联合实施(product-implement、architect-implement),再联合分析(product-analyze、architect-analyze)。

单轨运行 当简报只需一条轨道时,运行该轨道的入口工作流:仅产品用 workflow-product.yml(specify → clarify → gate-decisions → build-and-verify,产品命令,PDR 范围门禁);仅架构用 workflow-architecture.yml(同形状,架构命令,ADR 范围门禁)。每个入口沿用被移除孪生编排器的步骤形状与门禁上下文契约(records/since/link)。

路线选择 每条轨道有独立的路由输入(product_route、architecture_route),可各自选择 greenfield、brownfield(init)或 refresh(先分析);一条轨道可刷新而另一条走 greenfield。自适应(LLM)执行器在调度时解析路线;签入的 workflow.yml 编码 greenfield 默认(specify 轨道)以供无头执行。

边界与裁决 产品侧决定 WHAT / WHY / FOR WHOM(问题、人物、范围、优先级、业务指标、NFR 目标);任何回答 HOW 的内容(技术栈、模式、接口、NFR 机制)都记录为交给架构轨道的交接备注,不作为产品决策。重叠争议升级到指定人类,裁决作为决策输出发布到评论总线(人工裁决,无自动解决);在人工裁决落地前,自适应执行器不得运行联合实施。

共享执行器覆盖项 发布目标固定为本地(docs/adlc/memory/ 与 PRD/AD)。输出类型:specify/init → draft;clarify → decision;implement → artifact-ref;analyze → findings。纠错循环:每轨 HIGH/CRITICAL 回退到该轨 clarify,受 max_corrections 限制(默认 2),超出则暂停等待人工复核。监督默认混合:两次 clarify 与最终复核均设人工门禁,合并签署始终由人完成。预检会在 Phase 0 前确认 product-* 与 architect-* 生命周期技能均已安装。

工厂运行中的分支、提交与草稿 MR 需要 factory-mission 技能提供的运行助手:adlc-cli skills add tikalk/adlc-team-skills --skill factory-mission。在工厂运行中(ADLC_RUN_ID 已设置),只有本编排器——而非各轨道生命周期技能——通过三个助手执行提交、推送与草稿 MR:首步前运行 bash {REPO_ROOT}/.agents/skills/factory-mission/scripts/bash/run-branch.sh;每步变更后运行 commit-step.sh(传入该步写入、移动或删除的所有路径,且仅在生命周期写入允许列表内;不要暂存 .adlc/workflows/**),输出 sha 放入步骤总线标记;返回前始终运行 open-mr.sh,写入 mr_url 到 ADLC_STEP_OUTPUT,并写一行结论。Windows 使用 scripts/powershell/ 下的对应 PowerShell 版本。不要自行请求批准或等待回答。工厂运行外,助手仅在用户显式选择(adlc.commit_steps: true 或 --commit)时生效,run-branch.sh 与 open-mr.sh 无 ADLC_RUN_ID 时不动作;助手非零退出应上报而非绕过。