imansmallapple/conductor-dev

Conductor Dev

Overview

This skill provides the boilerplate files and structure for the Conductor project orchestration framework. It initializes a conductor/ directory with essential documentation and workflow definitions according to the Universal File Resolution Protocol. It supports both standard linear workflows and advanced cycle-based development (V4 Supercharged).

Workflow

1. Initialize Conductor

Scaffolds the conductor/ directory in the current project.

• Trigger: "Initialize conductor", "Setup conductor template", "Add conductor to project"
• Action:
  1. Create a conductor/ directory at the project root if it doesn't exist.
  2. Create an artifacts/snapshots/ directory at the project root if it doesn't exist.
  3. Create an artifacts/logs/ directory at the project root if it doesn't exist.
  4. Copy all template files from assets/conductor-template/ to the conductor/ directory using PowerShell-compatible commands.
  5. Inform the user that the Conductor directory and artifacts folder have been initialized.

2. Cycle Workflow (V4 Supercharged)

Executes a structured task cycle defined in conductor/workflows/cycle.md.

• Key Files: TASKS.md, SESSION_STATE.json (runtime), artifacts/logs/
• Design Context: Use the Figma Extension to inspect designs and extract CSS/ArkTS styling before implementation.
• Steps: Initialization -> Design Analysis (Figma) -> Strategy -> Execution -> Self-Review -> Synchronization -> Handover.

Implementation Directives

When implementing tracks or tasks under Conductor:

1. Design-First implementation: For all UI tasks, you MUST use the figma extension to fetch and analyze the relevant design files. Extract precise values for dimensions, colors, and typography to ensure pixel-perfect implementation.
2. Dynamic Path Resolution: ALWAYS resolve template paths relative to the skill's root directory.
3. Lint Before Commit: Execute codelinter on all modified files immediately after editing.
4. Task Verification:
   • For logic changes, rely primarily on codelinter to save tokens.
   • UI Validation (MANDATORY): For any UI modification, you MUST:
     1. Ensure a device/emulator is connected via hdc list targets.
     2. Ensure the artifacts/snapshots/ directory exists.
     3. Execute hdc shell snapshot_display /data/local/tmp/snapshot.png to capture the screen.
     4. Pull the screenshot using hdc file recv /data/local/tmp/snapshot.png "artifacts/snapshots/[task_id].png".
     5. Visual Comparison: Compare the captured snapshot against the Figma design. Note any discrepancies in the learning.md or log.
     6. (Optional but recommended) If the track specifies automated tests, run them (e.g., hvigorw test) and capture the final state or results as an additional snapshot.
5. Visual Proof: Save all UI validation snapshots to artifacts/snapshots/[task_id].png or artifacts/snapshots/[task_id]_test.png.
6. Idempotent Edits: Before using the replace tool, you MUST use read_file to verify the current content. Ensure that new_string is DIFFERENT from the existing text to avoid "No changes to apply" errors.
7. Automated Self-Learning Loop:
   • At the start of every track implementation or task, you MUST read conductor/learning.md. If it does not exist, create it with a # Learning Log header.
   • If an error happens, analyze and document the fix in conductor/learning.md.
   • Display Lessons: Proactively notify the user and explicitly display the content of "Lessons Learned" in the chat whenever conductor/learning.md is updated or after resolving errors or complex tasks.
8. Flexible Checkpointing: Commit changes after every task by default, but allow "Phase-based" commits if requested in the track plan.
9. Quality Standards: Adhere strictly to the project's product-guidelines.md and prioritize UI performance ("Premium Design" and "Robustness").
10. HarmonyOS Context: Read build-profile.json5 for SDK versions and cross-reference with API mapping.
11. Final Build Verification: ONLY after all phases in a track's plan.md are completed, you MUST execute hvigorw assembleHap as a final verification step to ensure the entire project is in a stable, buildable state before completing the track. Do not execute this command after individual tasks or phases.

Cross-Platform Compatibility

CRITICAL: When performing analysis or file operations, you MUST distinguish between available agent tools (e.g., read_file, grep_search) and shell commands. NEVER attempt to execute an agent tool name as a shell command within run_shell_command.

When performing project analysis or file operations, you MUST use commands compatible with the user's operating system.

• Windows (PowerShell): Use commands like Get-ChildItem, New-Item -ItemType Directory -Force (for mkdir -p), and avoid Unix-specific pipes like xargs.
• Unix (Bash): Standard Unix commands are acceptable.
• Path Resolution: Always use cross-platform path handling. In PowerShell, prefer $HOME over ~ for literal path strings.

Resources

assets/

Contains the template files for the Conductor directory structure:

• index.md: The entry point and file resolution index.
• product.md: Product definition and goals.
• tech-stack.md: Technology stack and architectural decisions.
• workflow.md: Development workflow and lifecycle.
• tracks.md: Registry for development tracks.
• product-guidelines.md: Design and implementation guidelines.
• setup_state.json: Initial state configuration for setup tracking.
• code_styleguides/: Directory for language-specific style guides (e.g., arkts.md).
• workflows/: Detailed workflow patterns (e.g., cycle.md for V4 Supercharged cycle).

Reference: HarmonyOS Version to API Level Mapping

| Version | API Level | | :--- | :--- | | 4.0 | 10 | | 4.1 | 11 | | 5.0.0 | 12 | | 5.0.1 | 13 | | 5.0.2 | 14 | | 5.0.3 | 15 | | 5.1.0 | 18 | | 5.1.1 | 19 | | 6.0 | 20 |

Note: If the version string in build-profile.json5 includes a number in parentheses, such as 6.0.0(20), the number in the parentheses is the API Level.