SuperAPI AI 工具集

cflx-workflow

编程与开发

查看项目

更新于 10-16 07:05

技能介绍

用途

cflx-workflow 是一个 Conflux 工作流执行技能(Conflux Workflow Executor),用于自主执行 Conflux 工作流操作。它由编排系统(orchestration system)调用,并非面向人直接使用。该技能明确不能向用户提问,所有决策必须基于可用上下文自主完成。

主要能力(三种操作模式)

操作模式由编排系统的调用方式决定:

  • apply:实现已批准的变更(Implement an approved change)。
  • accept:依据规格验证实现(Verify implementation against specs)。
  • archive:完成并归档已部署的变更(Finalize a deployed change)。

操作选择依据调用上下文判断:带有变更 ID 且含 “apply” 或 “implement” 上下文时执行 Apply;含 “accept” 或 “review” 上下文时执行 Accept;含 “archive” 上下文时执行 Archive。

Apply(实现)

目的:以任务跟踪的方式自主实现已批准的变更。关键约束包括:不提问题、不因难度或复杂度推迟任务、每完成一个任务后立即更新 tasks.md、只有在对应仓库变更与所需验证确实存在时才能将任务标记为 [x]、无法实现时记录 Implementation Blocker 供验收审查、不得仅凭提案/规格/tasks 编辑就勾选需要代码、测试或运行时接线的实现任务。执行步骤:读取 Proposal(proposal.md、design.md、tasks.md),按顺序处理任务,自主处理歧义,持续更新进度,并验证完成情况。

Accept(验收审查)

目的:通过自动化检查验证实现满足规格。最终必须只输出一个判定。所需检查包括:Git 工作区清洁(git status --porcelain 必须为空,脏工作区一律 FAIL)、任务完成度、规格匹配、集成检查、死代码检查、回归检查、证据引用,以及清单真实性检查。输出格式为 PASS / FAIL / CONTINUE / BLOCKED 之一;FAIL 时列出 FINDINGS 并更新 tasks.md 中的失败跟进项。

Archive(归档)

目的:归档已部署的变更并更新规范(canonical specs)。执行步骤:识别 Change ID、校验变更状态、运行归档、验证结果。归档完成标准:变更移动至 openspec/changes/archive/<id>/、规范更新(除非使用 --skip-specs)、--strict 校验通过。

使用方式

该技能通过内置工具脚本调用,涉及的主要命令包括:

  • 列出变更:python3 "$SKILL_ROOT/scripts/cflx.py" list
  • 列出规格:python3 "$SKILL_ROOT/scripts/cflx.py" list --specs
  • 查看变更详情:python3 "$SKILL_ROOT/scripts/cflx.py" show <id>
  • JSON 输出:python3 "$SKILL_ROOT/scripts/cflx.py" show <id> --json
  • 仅显示 deltas:python3 "$SKILL_ROOT/scripts/cflx.py" show <id> --json --deltas-only
  • 校验变更:python3 "$SKILL_ROOT/scripts/cflx.py" validate <id> --strict
  • 校验全部:python3 "$SKILL_ROOT/scripts/cflx.py" validate --strict
  • 归档变更:python3 "$SKILL_ROOT/scripts/cflx.py" archive <id> --yes
  • 不带规格更新归档:python3 "$SKILL_ROOT/scripts/cflx.py" archive <id> --yes --skip-specs

详细操作指南位于 references/cflx-apply.md、references/cflx-accept.md、references/cflx-archive.md。

自主决策框架

面对歧义情况时的优先级为:现有模式(遵循代码库中的模式)、规格(参考 spec deltas 与 scenarios)、简单性(选择更简单的实现)、文档(在代码注释中记录决策)。绝不允许:向用户请求澄清、停下等待输入、因不确定而遗留未完成任务。

适用场景

适用于自动化研发流程中,由编排系统驱动的变更实现、验收审查与归档环节,需要代理在无人工交互前提下自主完成任务跟踪、验证与规范更新。

限制

该技能不能向用户提问,不适用于人工直接使用。apply 中遇不可实现情况须以 Implementation Blocker 上报而非盲目循环;accept 中工作区脏一律 FAIL,ACCEPTANCE: BLOCKED 仅在存在有效 Implementation Blocker 且证据与解阻动作充分时才允许。此外,除上述内容外,关于该技能的收费、价格、平台支持与效果等事实暂未提供。