{
  "schemaVersion": "1.0",
  "item": {
    "slug": "pi-workflow",
    "name": "Pi Workflow Orchestration",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kai-tw/pi-workflow",
    "canonicalUrl": "https://clawhub.ai/kai-tw/pi-workflow",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/pi-workflow",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pi-workflow",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "HOOKS-INTEGRATION-COMPLETE.md",
      "README.md",
      "SKILL.md",
      "hooks/openclaw/HOOK.md",
      "hooks/openclaw/handler.js",
      "hooks/openclaw/handler.ts"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/pi-workflow"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/pi-workflow",
    "agentPageUrl": "https://openagent3.xyz/skills/pi-workflow/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pi-workflow/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pi-workflow/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Pi Workflow Orchestration",
        "body": "This skill provides Pi's structured approach to task management, quality assurance, and continuous self-improvement."
      },
      {
        "title": "1. Plan Node Default",
        "body": "Enter plan mode for ANY non-trivial task (3+ steps or architectural decisions):\n\nWrite detailed specs upfront to reduce ambiguity\nIf something goes sideways, STOP and re-plan immediately—don't keep pushing\nUse plan mode for verification steps, not just building"
      },
      {
        "title": "2. Subagent Strategy",
        "body": "Use subagents liberally to keep main context window clean\nOffload research, exploration, and parallel analysis to subagents\nFor complex problems, throw more compute at it via subagents\nOne tack per subagent for focused execution"
      },
      {
        "title": "3. Self-Improvement Loop",
        "body": "After ANY correction from the user: update tasks/lessons.md with metadata (Priority, Status, Area, Pattern-Key)\nLog command failures to tasks/errors.md for diagnosis patterns\nLog feature requests to tasks/feature_requests.md for future work\nWrite rules for yourself that prevent the same mistake\nRuthlessly iterate on these lessons until mistake rate drops\nReview lessons at session start for relevant projects\nTrack recurring patterns with Recurrence-Count (bump priority at ≥3 occurrences)"
      },
      {
        "title": "4. Verification Before Done",
        "body": "Never mark a task complete without proving it works\nDiff behavior between main and your changes when relevant\nAsk yourself: \"Would a staff engineer approve this?\"\nRun tests, check logs, demonstrate correctness"
      },
      {
        "title": "5. Demand Elegance (Balanced)",
        "body": "For non-trivial changes: pause and ask \"is there a more elegant way?\"\nIf a fix feels hacky: \"Knowing everything I know now, implement the elegant solution\"\nSkip this for simple, obvious fixes—don't over-engineer\nChallenge your own work before presenting it"
      },
      {
        "title": "6. Autonomous Bug Fixing",
        "body": "When given a bug report: just fix it. Don't ask for hand-holding\nPoint at logs, errors, failing tests—then resolve them\nZero context switching required from the user\nGo fix failing CI tests without being told how"
      },
      {
        "title": "Task Management",
        "body": "Plan First: Write plan to tasks/todo.md with checkable items\nVerify Plan: Check in before starting implementation\nTrack Progress: Mark items complete as you go\nExplain Changes: High-level summary at each step\nDocument Results: Add review section to tasks/todo.md\nCapture Lessons: Update tasks/lessons.md after corrections"
      },
      {
        "title": "File Organization",
        "body": "tasks/todo.md — active sprint (current project)\ntasks/lessons.md — corrections, insights, best practices (structured)\ntasks/errors.md — command failures, API errors, exceptions (NEW)\ntasks/feature_requests.md — missing capabilities, feature requests (NEW)\nmemory/YYYY-MM-DD.md — session logs (daily)\nMEMORY.md — your curated memories (maintained by user)\n\nSee WORKFLOW_ORCHESTRATION.md for detailed reference.\n\nSee LESSONS.md for philosophy and framing.\n\nSee PHASE1-PHASE2-ENHANCED-LESSONS.md for structured lesson format and file separation.\n\nSee LESSONS_UPDATE_GUIDE.md for syncing lessons from workspace to skill."
      },
      {
        "title": "Lessons Format (Phase 1+2 Enhanced)",
        "body": "Each lesson gets structured metadata for filtering and recurring pattern detection:\n\n## [LRN-YYYYMMDD-XXX] rule_name (category)\n\n**Logged**: ISO-8601 timestamp\n**Priority**: low | medium | high | critical\n**Status**: pending | in_progress | resolved | promoted\n**Area**: backend | infra | tests | docs | config\n**Pattern-Key**: category.pattern_name (optional, for recurring detection)\n\n### Summary\nOne-line description\n\n### Details\nFull context and examples\n\n### Applied to\nProjects or files where this was used\n\n### Metadata\n- Source: correction | insight | user_feedback\n- Related Files: path/to/file\n- Tags: tag1, tag2\n- See Also: LRN-20250225-001 (if related to existing entry)\n- Recurrence-Count: 1 (increment if you see it again)\n- First-Seen: 2025-02-23\n- Last-Seen: 2025-02-23"
      },
      {
        "title": "Errors & Features (NEW)",
        "body": "Log failures and feature gaps separately for better organization:\n\nErrors (tasks/errors.md):\n\nCommand failures, API errors, exceptions\nInclude reproducibility, environment, suggested fix\n\nFeatures (tasks/feature_requests.md):\n\nMissing capabilities, things you wish existed\nInclude complexity estimate and suggested implementation"
      },
      {
        "title": "Syncing to Skill",
        "body": "Periodically merge workspace lessons into the published skill:\n\n# From openclaw-workflow repo\npython3 scripts/sync_lessons.py --workspace ~/.openclaw/workspace\n\n# Dry run (preview changes)\npython3 scripts/sync_lessons.py --workspace ~/.openclaw/workspace --dry-run\n\nThis merges workspace lessons into references/lessons.md for version control and sharing."
      },
      {
        "title": "Hooks (Optional)",
        "body": "Enable automatic bootstrap reminders for self-improvement:\n\nopenclaw hooks enable pi-workflow\n\nThis injects a reminder at session start showing:\n\nWhen to log lessons/errors/features\nFormat and metadata fields\nRecurring pattern detection\nPromotion paths\n\nSee hooks/openclaw/HOOK.md for details."
      },
      {
        "title": "Core Principles",
        "body": "Simplicity First: Make every change as simple as possible. Minimal code impact.\nNo Laziness: Find root causes. No temporary fixes. Senior developer standards.\nMinimal Impact: Changes should only touch what's necessary. Avoid introducing bugs."
      }
    ],
    "body": "Pi Workflow Orchestration\n\nThis skill provides Pi's structured approach to task management, quality assurance, and continuous self-improvement.\n\nCore Workflows\n1. Plan Node Default\n\nEnter plan mode for ANY non-trivial task (3+ steps or architectural decisions):\n\nWrite detailed specs upfront to reduce ambiguity\nIf something goes sideways, STOP and re-plan immediately—don't keep pushing\nUse plan mode for verification steps, not just building\n2. Subagent Strategy\nUse subagents liberally to keep main context window clean\nOffload research, exploration, and parallel analysis to subagents\nFor complex problems, throw more compute at it via subagents\nOne tack per subagent for focused execution\n3. Self-Improvement Loop\nAfter ANY correction from the user: update tasks/lessons.md with metadata (Priority, Status, Area, Pattern-Key)\nLog command failures to tasks/errors.md for diagnosis patterns\nLog feature requests to tasks/feature_requests.md for future work\nWrite rules for yourself that prevent the same mistake\nRuthlessly iterate on these lessons until mistake rate drops\nReview lessons at session start for relevant projects\nTrack recurring patterns with Recurrence-Count (bump priority at ≥3 occurrences)\n4. Verification Before Done\nNever mark a task complete without proving it works\nDiff behavior between main and your changes when relevant\nAsk yourself: \"Would a staff engineer approve this?\"\nRun tests, check logs, demonstrate correctness\n5. Demand Elegance (Balanced)\nFor non-trivial changes: pause and ask \"is there a more elegant way?\"\nIf a fix feels hacky: \"Knowing everything I know now, implement the elegant solution\"\nSkip this for simple, obvious fixes—don't over-engineer\nChallenge your own work before presenting it\n6. Autonomous Bug Fixing\nWhen given a bug report: just fix it. Don't ask for hand-holding\nPoint at logs, errors, failing tests—then resolve them\nZero context switching required from the user\nGo fix failing CI tests without being told how\nTask Management\nPlan First: Write plan to tasks/todo.md with checkable items\nVerify Plan: Check in before starting implementation\nTrack Progress: Mark items complete as you go\nExplain Changes: High-level summary at each step\nDocument Results: Add review section to tasks/todo.md\nCapture Lessons: Update tasks/lessons.md after corrections\nFile Organization\ntasks/todo.md — active sprint (current project)\ntasks/lessons.md — corrections, insights, best practices (structured)\ntasks/errors.md — command failures, API errors, exceptions (NEW)\ntasks/feature_requests.md — missing capabilities, feature requests (NEW)\nmemory/YYYY-MM-DD.md — session logs (daily)\nMEMORY.md — your curated memories (maintained by user)\n\nSee WORKFLOW_ORCHESTRATION.md for detailed reference.\n\nSee LESSONS.md for philosophy and framing.\n\nSee PHASE1-PHASE2-ENHANCED-LESSONS.md for structured lesson format and file separation.\n\nSee LESSONS_UPDATE_GUIDE.md for syncing lessons from workspace to skill.\n\nCapturing Lessons\nLessons Format (Phase 1+2 Enhanced)\n\nEach lesson gets structured metadata for filtering and recurring pattern detection:\n\n## [LRN-YYYYMMDD-XXX] rule_name (category)\n\n**Logged**: ISO-8601 timestamp\n**Priority**: low | medium | high | critical\n**Status**: pending | in_progress | resolved | promoted\n**Area**: backend | infra | tests | docs | config\n**Pattern-Key**: category.pattern_name (optional, for recurring detection)\n\n### Summary\nOne-line description\n\n### Details\nFull context and examples\n\n### Applied to\nProjects or files where this was used\n\n### Metadata\n- Source: correction | insight | user_feedback\n- Related Files: path/to/file\n- Tags: tag1, tag2\n- See Also: LRN-20250225-001 (if related to existing entry)\n- Recurrence-Count: 1 (increment if you see it again)\n- First-Seen: 2025-02-23\n- Last-Seen: 2025-02-23\n\nErrors & Features (NEW)\n\nLog failures and feature gaps separately for better organization:\n\nErrors (tasks/errors.md):\n\nCommand failures, API errors, exceptions\nInclude reproducibility, environment, suggested fix\n\nFeatures (tasks/feature_requests.md):\n\nMissing capabilities, things you wish existed\nInclude complexity estimate and suggested implementation\nSyncing to Skill\n\nPeriodically merge workspace lessons into the published skill:\n\n# From openclaw-workflow repo\npython3 scripts/sync_lessons.py --workspace ~/.openclaw/workspace\n\n# Dry run (preview changes)\npython3 scripts/sync_lessons.py --workspace ~/.openclaw/workspace --dry-run\n\n\nThis merges workspace lessons into references/lessons.md for version control and sharing.\n\nHooks (Optional)\n\nEnable automatic bootstrap reminders for self-improvement:\n\nopenclaw hooks enable pi-workflow\n\n\nThis injects a reminder at session start showing:\n\nWhen to log lessons/errors/features\nFormat and metadata fields\nRecurring pattern detection\nPromotion paths\n\nSee hooks/openclaw/HOOK.md for details.\n\nCore Principles\nSimplicity First: Make every change as simple as possible. Minimal code impact.\nNo Laziness: Find root causes. No temporary fixes. Senior developer standards.\nMinimal Impact: Changes should only touch what's necessary. Avoid introducing bugs."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/kai-tw/pi-workflow",
    "publisherUrl": "https://clawhub.ai/kai-tw/pi-workflow",
    "owner": "kai-tw",
    "version": "1.1.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/pi-workflow",
    "downloadUrl": "https://openagent3.xyz/downloads/pi-workflow",
    "agentUrl": "https://openagent3.xyz/skills/pi-workflow/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pi-workflow/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pi-workflow/agent.md"
  }
}