SuperAPI AI 工具集

mission-specify

智能体与模型

查看项目

更新于 10-30 23:24

技能介绍

mission-specify

依赖:需要 factory-mission 技能提供的共享执行器契约,位于 .agents/skills/factory-mission/references/executor.md(安装路径);可用 adlc-cli skills add tikalk/adlc-team-skills --skill factory-mission 安装。

本地会话中由你回答门禁问题:

当 ADLC_RUN_ID 未设置、当前会话中有真人、且没有其他程序会回答门禁时,走本地模式。把门禁中继到 Slack 的 agentic-container 运行时只存在于 runner pod 中。

运行暂停不是任务结束,而是轮到你处理。当 adlc-cli workflow run 或 resume 因门禁而暂停退出(run_paused,adlc-cli workflow state show <run_id> 中 status: paused),向当事人提出该门禁的问题与选项,然后运行 adlc-cli workflow resume <run_id> --input <verdict_input>=<answer> 并继续推进。绝不要在无人被询问的情况下,于运行暂停时结束回合。

每个批准 MR 的门禁之后都跟着一个创建 MR 的步骤。若门禁消息承诺产出 MR/PR,其后必须有发布步骤:对改动涉及的每个仓库运行 run-branch.sh 与 open-mr.sh,写入 mr_url(多个时为 mr_urls)。之后才是回写步骤,使完成评论能链接真实的 MR。门禁之后没有任何步骤执行其答案,属于计划缺陷;应在开始运行前修正计划。

结束回合前,运行必须处于 completed、failed 或 aborted,或暂停于一个已被询问当事人的门禁。

本技能做什么:

mission-specify 拥有 mission SDD 系列的 specify 阶段:它把任务的 brief.md 转成 spec.md,使每条验收标准都能被判为是或否,并记录为此做出的决策。它在共享执行器契约(.agents/skills/factory-mission/references/executor.md)下工作:specify 步骤读取 brief.md 并产出草稿,clarify 步骤读取 spec.md 并产出决策,reads_from 由编排器解析。它止步于规格——规划属于 mission-plan,构建属于 mission-implement,验证与收敛属于 mission-verify,REVIEW 与 SHIP 属于 factory-review 与 factory-deploy。

默认流程:

读取 brief.md;将其目标、约束、非目标与成功标准视为输入,而非需要原样保留的措辞。

把每条成功标准重述为二值、可度量的结果——每条都通过退出命令、存在的产物或显示改动的 diff 来回答一个是/否问题。

编写 spec.md:结果、约束、非目标、验收标准与范围之外。每条验收标准都能追溯到它所重述的成功标准。

暴露任何无法度量的标准以及相互冲突的约束;不要在文字描述中掩盖任何一项。

在 clarify 阶段解决每个暴露项——门禁运行中询问当事人,自主模式下记录决策及其依据。产生的决策即 clarify 的输出。

绝不选择技术,绝不规划文件;这些属于后续阶段。

步骤契约:

步骤:specify;phase_type:generate;output_type:draft;reads_from:brief.md;产物:spec.md。

步骤:clarify;phase_type:clarify;output_type:decision;reads_from:spec.md;产物:—。

门禁:本阶段无门禁。

边界:

不建 worktree:隔离属于编排器;本技能在交给它的工作树中工作。

不持有租约:绝不获取、续期或释放运行租约。

不写跟踪系统:不写评论、标签、状态迁移,也不创建 MR/PR。

不合并、不批准:本技能绝不批准、合并或发布。

回流:无法度量的标准或冲突的约束会停留在 clarify 直到解决;事后被证明错误的规格通过其所属的 clarify 阶段修正,绝不通过在下游悄悄修改验收标准来掩盖。