用途
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 且证据与解阻动作充分时才允许。此外,除上述内容外,关于该技能的收费、价格、平台支持与效果等事实暂未提供。