OpenParable
Skip to content
← Back to skills

Macos QA Test

Testing & Quality
macos-qa-test

Macos QA Test is an Agent Skill for testing & quality published in the performancecopilot/pcp repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run darwin PMDA QA tests in isolated Cirrus VM environment

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/performancecopilot/pcp/blob/HEAD/.claude/skills/macos-qa-test/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/macos-qa-test, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Darwin PMDA QA Test Runner

This skill runs the full darwin PMDA build and test suite in an isolated Cirrus CI VM environment.

Usage

Run this command to execute the darwin PMDA QA tests:

/macos-qa-test

What This Does

  1. Invokes the macos-darwin-pmda-qa agent
  2. Runs cirrus run --dirty to execute:
    • Full PCP build from source
    • Darwin PMDA compilation
    • Unit tests (via dbpmda)
    • Integration tests (via pminfo/pmval)
  3. Reports test results back to you

Expected Runtime

  • Normal execution: 5-6 minutes
  • The VM will be provisioned, tests run, and results reported

Success Indicators

  • ✅ All build and test steps pass
  • Note: "unmounting the working directory" failure at end is expected/normal

When to Use

  • After making AND COMMITTING changes to src/pmdas/darwin or src/pmdas/darwin_proc
  • To validate new metrics or bug fixes in a clean environment
  • Before pushing changes to remote

CRITICAL: Git Commit Required

You MUST commit all source code changes to git BEFORE running this skill.

The Tart VM clones the git repository. Uncommitted local changes are INVISIBLE to the VM.

# Correct workflow:
git add <changed-files>
git commit -m "Add new metric for X"
/macos-qa-test              # NOW the VM will see your changes

If tests fail on code you just wrote, verify you committed the changes first


When invoked, immediately use the Task tool to launch the macos-darwin-pmda-qa agent with a simple prompt like "Run darwin PMDA QA tests for recent changes".