{
  "schemaVersion": "1.0",
  "item": {
    "slug": "software-engineer",
    "name": "Software Engineer",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/software-engineer",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/software-engineer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/software-engineer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=software-engineer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "architecture.md",
      "patterns.md",
      "testing.md"
    ],
    "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. 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. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "software-engineer",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T06:03:09.971Z",
      "expiresAt": "2026-05-16T06:03:09.971Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=software-engineer",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=software-engineer",
        "contentDisposition": "attachment; filename=\"software-engineer-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "software-engineer"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/software-engineer"
    },
    "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/software-engineer",
    "agentPageUrl": "https://openagent3.xyz/skills/software-engineer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/software-engineer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/software-engineer/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "When to Use",
        "body": "Agent needs to write, review, or refactor code. Handles implementation decisions, architecture trade-offs, and code quality across any language or framework."
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileCode patternspatterns.mdArchitecture decisionsarchitecture.mdTesting practicestesting.md"
      },
      {
        "title": "1. Read Before Write",
        "body": "Check existing code style, patterns, and conventions before writing new code\nRespect the current stack — never swap libraries without explicit request\nMatch naming conventions, formatting, and project structure already in place"
      },
      {
        "title": "2. Code That Compiles",
        "body": "Every code block must:\n\nHave correct imports for the actual library versions in use\nUse APIs that exist in the project's dependency versions\nPass basic syntax checks — no placeholder // TODO: implement"
      },
      {
        "title": "3. Minimal First",
        "body": "Solve the specific problem, not hypothetical future problems\nOne abstraction when you have three concrete cases, not before\nFeatures that might be needed → skip. Features that are needed → implement"
      },
      {
        "title": "4. Errors as First-Class Citizens",
        "body": "❌ catch (e) {}\n❌ catch (e) { console.log(e) }\n✅ catch (e) { logger.error('context', { error: e, input }); throw new DomainError(...) }\n\nTyped errors over generic strings\nInclude context: what operation failed, with what input\nDistinguish recoverable vs fatal errors"
      },
      {
        "title": "5. Boundaries and Separation",
        "body": "LayerContainsNever ContainsHandler/ControllerHTTP/CLI parsing, validationBusiness logic, SQLService/DomainBusiness rules, orchestrationInfrastructure detailsRepository/AdapterData access, external APIsBusiness decisions"
      },
      {
        "title": "6. Explicit Trade-offs",
        "body": "When making architectural choices, state:\n\nWhat you chose and why\nWhat you traded away\nWhen to revisit the decision\n\nExample: \"Using SQLite for simplicity. Trade-off: no concurrent writes. Revisit if >1 write/sec needed.\""
      },
      {
        "title": "7. PR-Ready Code",
        "body": "Before delivering any code:\n\nNo dead code, commented blocks, or debug statements\n Functions under 30 lines\n No magic numbers — use named constants\n Early returns over nested conditionals\n Edge cases handled: null, empty, error states"
      },
      {
        "title": "Code Quality Signals",
        "body": "Senior code reads like prose:\n\nNames explain \"what\" and \"why\", not \"how\"\nA junior understands it in 30 seconds\nNo cleverness that requires comments to explain\n\nThe best code is boring:\n\nPredictable patterns\nStandard library over dependencies when reasonable\nExplicit over implicit"
      },
      {
        "title": "Common Traps",
        "body": "TrapConsequencePreventionInventing APIsCode doesn't compileVerify method exists in docs firstOver-engineering3 hours instead of 30 minAsk: \"Do I have 3 concrete cases?\"Ignoring contextSuggests wrong stackRead existing files before suggestingCopy-paste without understandingHidden bugs surface laterExplain what the code doesEmpty error handlingSilent failures in productionAlways log + type + rethrowPremature abstractionComplexity without benefitYAGNI until proven otherwise"
      },
      {
        "title": "Pragmatic Shipping",
        "body": "Critical paths (do it right):\n\nAuthentication, authorization\nPayment processing\nData integrity, migrations\nSecrets management\n\nExperimental paths (ship fast, iterate):\n\nUI/UX features\nAdmin panels\nAnalytics\nAnything unvalidated with users\n\nTest for critical path: \"Can this wake me at 3am or lose money?\""
      },
      {
        "title": "Security & Privacy",
        "body": "This skill does NOT:\n\nStore any data externally\nMake network requests\nAccess files outside the current project\n\nAll code suggestions are generated in context of the conversation."
      }
    ],
    "body": "When to Use\n\nAgent needs to write, review, or refactor code. Handles implementation decisions, architecture trade-offs, and code quality across any language or framework.\n\nQuick Reference\nTopic\tFile\nCode patterns\tpatterns.md\nArchitecture decisions\tarchitecture.md\nTesting practices\ttesting.md\nCore Rules\n1. Read Before Write\nCheck existing code style, patterns, and conventions before writing new code\nRespect the current stack — never swap libraries without explicit request\nMatch naming conventions, formatting, and project structure already in place\n2. Code That Compiles\n\nEvery code block must:\n\nHave correct imports for the actual library versions in use\nUse APIs that exist in the project's dependency versions\nPass basic syntax checks — no placeholder // TODO: implement\n3. Minimal First\nSolve the specific problem, not hypothetical future problems\nOne abstraction when you have three concrete cases, not before\nFeatures that might be needed → skip. Features that are needed → implement\n4. Errors as First-Class Citizens\n❌ catch (e) {}\n❌ catch (e) { console.log(e) }\n✅ catch (e) { logger.error('context', { error: e, input }); throw new DomainError(...) }\n\nTyped errors over generic strings\nInclude context: what operation failed, with what input\nDistinguish recoverable vs fatal errors\n5. Boundaries and Separation\nLayer\tContains\tNever Contains\nHandler/Controller\tHTTP/CLI parsing, validation\tBusiness logic, SQL\nService/Domain\tBusiness rules, orchestration\tInfrastructure details\nRepository/Adapter\tData access, external APIs\tBusiness decisions\n6. Explicit Trade-offs\n\nWhen making architectural choices, state:\n\nWhat you chose and why\nWhat you traded away\nWhen to revisit the decision\n\nExample: \"Using SQLite for simplicity. Trade-off: no concurrent writes. Revisit if >1 write/sec needed.\"\n\n7. PR-Ready Code\n\nBefore delivering any code:\n\n No dead code, commented blocks, or debug statements\n Functions under 30 lines\n No magic numbers — use named constants\n Early returns over nested conditionals\n Edge cases handled: null, empty, error states\nCode Quality Signals\n\nSenior code reads like prose:\n\nNames explain \"what\" and \"why\", not \"how\"\nA junior understands it in 30 seconds\nNo cleverness that requires comments to explain\n\nThe best code is boring:\n\nPredictable patterns\nStandard library over dependencies when reasonable\nExplicit over implicit\nCommon Traps\nTrap\tConsequence\tPrevention\nInventing APIs\tCode doesn't compile\tVerify method exists in docs first\nOver-engineering\t3 hours instead of 30 min\tAsk: \"Do I have 3 concrete cases?\"\nIgnoring context\tSuggests wrong stack\tRead existing files before suggesting\nCopy-paste without understanding\tHidden bugs surface later\tExplain what the code does\nEmpty error handling\tSilent failures in production\tAlways log + type + rethrow\nPremature abstraction\tComplexity without benefit\tYAGNI until proven otherwise\nPragmatic Shipping\n\nCritical paths (do it right):\n\nAuthentication, authorization\nPayment processing\nData integrity, migrations\nSecrets management\n\nExperimental paths (ship fast, iterate):\n\nUI/UX features\nAdmin panels\nAnalytics\nAnything unvalidated with users\n\nTest for critical path: \"Can this wake me at 3am or lose money?\"\n\nSecurity & Privacy\n\nThis skill does NOT:\n\nStore any data externally\nMake network requests\nAccess files outside the current project\n\nAll code suggestions are generated in context of the conversation."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/software-engineer",
    "publisherUrl": "https://clawhub.ai/ivangdavila/software-engineer",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/software-engineer",
    "downloadUrl": "https://openagent3.xyz/downloads/software-engineer",
    "agentUrl": "https://openagent3.xyz/skills/software-engineer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/software-engineer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/software-engineer/agent.md"
  }
}