Conflux workflow management skills for AI coding assistants.

This repository contains three complementary skills for managing the Conflux (OpenSpec-based) change lifecycle:

[Human] → cflx-proposal → Proposal Creation (interactive)
                ↓
        [Committed change on base branch]
                ↓
           cflx-run → `cflx run` orchestration
                ↓
        cflx-workflow (apply) → Implementation (autonomous)
                ↓
        cflx-workflow (accept) → Verification (autonomous)
                ↓
        cflx-workflow (archive) → Finalization (autonomous)

Purpose: Create structured change proposals through interactive conversation with users.

Characteristics:

• Human-interactive mode
• Asks clarifying questions
• Guides users through proposal structure
• Iterates based on feedback

Triggers:

• "Create a proposal for..."
• "Draft a change proposal"
• "Propose a new feature"

Purpose: Execute Conflux workflow operations autonomously without user interaction.

Characteristics:

• Called by orchestration system
• Cannot ask questions
• Makes autonomous decisions
• Three operations: apply, accept, archive

Operations:

Purpose: Prepare a clean base branch and run cflx run for committed OpenSpec changes.

Characteristics:

• Human-invoked operational mode
• Verifies clean working tree and base branch
• Checks whether upstream sync is needed
• Runs Conflux orchestration and reviews the merge result

npx skills add tumf/cflx-skills

This will install all three skills:

• cflx-proposal - For interactive proposal creation
• cflx-run - For executing cflx run from a clean base branch
• cflx-workflow - For autonomous workflow execution

• Python 3.6+: Required for the built-in "$SKILL_ROOT/scripts/cflx.py" tool
• Git: For version control operations
• No Node.js required: All operations are implemented in Python

Both skills include "$SKILL_ROOT/scripts/cflx.py", a standalone Python implementation that replaces the need for @fission-ai/openspec npm package.

# List changes
python3 "$SKILL_ROOT/scripts/cflx.py" list

# List specs
python3 "$SKILL_ROOT/scripts/cflx.py" list --specs

# Show change details
python3 "$SKILL_ROOT/scripts/cflx.py" show <id>

# Validate change
python3 "$SKILL_ROOT/scripts/cflx.py" validate <id> --strict

# Archive change
python3 "$SKILL_ROOT/scripts/cflx.py" archive <id> --yes

openspec/
├── changes/
│   ├── <change-id>/
│   │   ├── proposal.md
│   │   ├── tasks.md
│   │   ├── design.md (optional)
│   │   └── specs/
│   │       └── <capability>/
│   │           └── spec.md
│   └── archive/
└── specs/
    └── <capability>/
        └── spec.md

• Mock/stub/fixture external dependencies for verification
• Do not block on missing API keys or credentials
• Only truly non-mockable dependencies go to Future Work

• Update tasks.md immediately after each task completion
• Active sections must have checkboxes (- [ ] or - [x])
• Future Work sections must NOT have checkboxes

• Apply can escalate IMPLEMENTATION_BLOCKER when implementation is truly impossible in current loop
• Accept can return ACCEPTANCE: BLOCKED only with concrete blocker evidence

• No questions allowed during execution
• Make decisions based on available context
• Do not defer tasks based on difficulty

MIT