{
  "markdown": "# Devkit\n\nDeveloper toolkit — reusable engineering, operations, reporting, writing, and\nartifact skills for AI agents across major coding platforms.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| **using-devkit** | Unified Devkit entry-point: discovers skills and routes repository work through SIES from L0 to L3 |\n| **sies-engineering** | Goal-first, evidence-driven engineering: Goal → Explore → Prototype → Evaluate → Refine → Engineer → Regress → Learn |\n| **friendly-python** | Python code cleanup: Pyright strict mode, modern typing, automated formatting (`ruff`), Pylint fix patterns |\n| **humanizing-writing** | Chinese and English prose cleanup: preserves facts and voice while removing formulaic AI-writing patterns from everyday text, technical docs, and PR descriptions |\n| **taste-skill** | Context-aware web design and redesign guidance that respects the existing stack, brand system, accessibility, and real content |\n| **image-to-code-skill** | Faithful web implementation from screenshots, Figma frames, and approved visual references with viewport-based comparison |\n| **imagegen-frontend-web** | Image-only website concepts and section references with coherent art direction and implementation-readable detail |\n| **imagegen-frontend-mobile** | Image-only native mobile screens and flows for iOS, Android, and cross-platform products |\n| **pptx** | Safe PowerPoint creation/editing plus traceable weekly, monthly, architecture, MVP, release, and project-status reporting |\n| **deployment-operations** | Target-aware deployment, release, rollback, runtime diagnosis, health verification, and incident response |\n| **production-statistics** | Explicit production metrics through dedicated read-only database access and sanitized aggregate outputs |\n| **mihomo-proxy-setup** | User-space Mihomo proxy installer: Clash subscription, Web UI, dev tool wrappers (Cursor/Copilot/Claude), Linux + macOS |\n| **github-create-issue** | Adaptive SIES Issue profiles for goals, exploration, prototypes, engineering, bugs, and learning |\n| **github-issue-workflow** | Recovers existing goals/evidence and resumes at the first unresolved SIES decision |\n| **github-product-manager** | Uncertainty-driven product discovery that produces evaluable Goal Contracts |\n\n## Installation\n\nOne-liner install — pick your platform:\n\n**macOS / Linux:**\n\n```bash\n# curl cannot show the interactive menu; specify a platform directly\ncurl -fsSL https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.sh | bash -s -- claude\n\n# Local clone interactive menu\nbash scripts/install.sh\n```\n\n**Windows (PowerShell):**\n\n```powershell\n# Interactive menu\n& ([scriptblock]::Create((irm https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.ps1)))\n\n# Or specify a platform directly\n& ([scriptblock]::Create((irm https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.ps1))) -Platform claude\n```\n\nSupported platforms: `claude` · `cursor` · `copilot` · `codex` · `opencode` · `gemini`\n\n<details>\n<summary>Manual installation</summary>\n\n### Claude Code\n\n```bash\nclaude plugins marketplace add https://github.com/zhpeng24/devkit.git\nclaude plugins install devkit\n```\n\n### Cursor\n\n```bash\ngit clone https://github.com/zhpeng24/devkit.git ~/.cursor/plugins/local/devkit\n# Restart Cursor to detect the plugin\n```\n\nCursor loads the plugin for agent use. In Cursor 4.17, plugin skills may auto-trigger from natural language instead of appearing as slash commands.\n\n### GitHub Copilot CLI\n\n```bash\ngit clone https://github.com/zhpeng24/devkit.git ~/.copilot/plugins/devkit\ncopilot plugin install ~/.copilot/plugins/devkit\n```\n\n### Codex\n\n```bash\ngit clone https://github.com/zhpeng24/devkit.git ~/.codex/devkit\nmkdir -p ~/.agents/skills\nln -s ~/.codex/devkit/skills ~/.agents/skills/devkit\n```\n\n### OpenCode\n\nAdd to `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"devkit@git+https://github.com/zhpeng24/devkit.git\"]\n}\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/zhpeng24/devkit.git\n```\n\n</details>\n\n## What's Inside\n\n### SIES engineering\n\nSIES (Self-Improving Engineering System) is the default development sequence:\n\n```text\nGoal → Explore → Prototype → Evaluate → Refine → Engineer → Regress → Learn\n```\n\n`using-devkit` routes repository changes into `sies-engineering`; L0–L3 controls\nhow deeply phases are expressed rather than selecting unrelated fixed\nworkflows. Tests remain important evidence for goal alignment, stable\ncontracts, and real risks. TDD is selected inside Engineering when a stable\nexpected behavior makes test-first useful—it is not the lifecycle for every\nchange.\n\nGitHub stores recoverable goals, evidence, decisions, and delivery links.\nIssues can move backward to exploration, stop without code, or compress phases\nwhen the work is deterministic.\n\n### Project profiles\n\nProjects can commit `.devkit/project.json` to provide reusable skills with\nproject-specific facts without hardcoding them into Devkit. The profile can\ndeclare native commands, canonical workspaces, development-process rules,\ntesting/staging/production targets, health checks, approved statistics access,\nand reporting cadence.\n\nCopy `skills/using-devkit/assets/project.example.json` as a starting point.\nProfiles contain defaults, not authorization, and must never contain passwords,\ntokens, private keys, or other secrets.\n\n### friendly-python\n\nA comprehensive Python code cleanup skill that enforces:\n\n- **Pyright strict mode** with proper venv configuration\n- **Modern Python 3.12+** — `type` statements, built-in generics, `X | None`\n- **Automated formatting** — `ruff format`, `ruff check --select I`\n- **Full type annotations** — parameters, returns, instance attributes\n- **Clean imports** — no empty `__init__.py`, no `TYPE_CHECKING`, no re-exports\n- **Pylint fix patterns** — unused arguments, broad exceptions, import ordering\n- **TypedDict / Protocol / Literal** over loose `dict` / `Any`\n\n### humanizing-writing\n\nA prose cleanup skill for Chinese and English writing that:\n\n- **Routes by context** — adapts everyday writing, technical documentation, and PR descriptions\n- **Preserves facts and protected spans** — keeps names, numbers, commands, code, and links intact\n- **Calibrates to author samples** — matches the writer's existing voice when examples are provided\n- **Protects against false positives** — avoids changing clear, intentional, or already-natural phrasing\n\n### taste-skill\n\nWeb design guidance that reads the product, audience, brand assets, existing\nstack, and constraints before choosing a visual direction. It covers redesign\naudits, responsive behavior, accessibility, real UI states, asset rights, and\nrendered verification without forcing React/Next or a stock “AI” aesthetic.\n\n### image-to-code-skill\n\nAn implementation workflow for screenshots, Figma frames, and approved visual\nreferences. It inventories layout and visual tokens before coding, keeps the\nexisting project stack, and verifies fidelity at the source viewport plus\nresponsive variants.\n\n### imagegen-frontend-web\n\nCreates image-only website references. Image count follows the requested\nsections, frames share one visual system, and each output stays readable enough\nfor downstream implementation.\n\n### imagegen-frontend-mobile\n\nCreates image-only native mobile screens and flows with platform-aware safe\nareas, navigation, touch geometry, readable type, and consistent product\nstates. Frame-free implementation references are supported.\n\n### pptx\n\nA clean-room PowerPoint workflow for reading, creating, and safely editing\n`.pptx`/`.potx` files. It preserves the source, preflights available libraries\nand renderers, checks package/content integrity, and distinguishes completed\nvisual QA from unverified rendering. Repository-backed reporting adds real\ngit/tracker provenance, previous-plan comparison, stable metric definitions,\ndiffable `report.md` + `data.json` sources, recurring archives, and weekly,\nmonthly, architecture, MVP, release, or project-status narrative arcs.\n\n### deployment-operations\n\nA target-aware operations workflow for planning, deployment, local runtime\nstartup, diagnosis, rollback, and hardening. It reads project-native contracts\nand optional project-profile environments, starts with bounded read-only\nevidence, distinguishes liveness from readiness, changes the smallest coherent\nunit, and repeats the original probe before declaring recovery.\n\n### production-statistics\n\nA narrow production reporting workflow separated from deployment and\ndevelopment. It requires explicit production-statistics intent, a dedicated\nread-only account, bounded aggregate queries, database-native read-only\ntransactions and timeouts, sanitized tables/charts, and transparent metric\ndefinitions. DDL, DML, repair, raw PII exports, and administrator shortcuts are\noutside the skill.\n\n### mihomo-proxy-setup\n\nA complete user-space proxy installer and manager:\n\n- **Mihomo (Clash.Meta)** binary — auto-detects OS and architecture\n- **Clash subscription** integration with auto-update (every 30 min)\n- **MetaCubeXD Web UI** panel for managing proxy rules\n- **Proxy wrappers** — `with-proxy`, `proxy-agent`, `proxy-copilot`, `proxy-claude`\n- **Service management** — systemd (Linux) / launchd (macOS) user services\n- **Uninstall** — full cleanup of all files, services, and configuration\n- **No root required** — everything runs in user space\n\n### github-create-issue\n\nSelects the smallest useful Issue profile for the current decision:\n\n- **Goal/Product** — outcome, success signals, non-goals, and evaluation\n- **Exploration** — hypotheses, evidence plan, budget, and stop condition\n- **Prototype** — minimal artifact boundary and promotion/disposal rule\n- **Engineering/Bug** — selected change, risks, contracts, and verification map\n- **Learning** — evidence-backed proposal for reusable system improvement\n\nIt preserves safe `gh issue create --body-file` execution without forcing\nevery kind of work into one template or adding a duplicate preview after direct\nauthorization.\n\n### github-issue-workflow\n\nA phase-aware controller for existing Issues:\n\n- recovers Goal and Evaluation Contracts from SIES or legacy Issue bodies\n- resumes from the first unsupported decision instead of replaying a workflow\n- allows Evaluation to return to Exploration/Prototype or stop without code\n- chooses branches, worktrees, review depth, and tests from actual risk\n- preserves trusted Issue targeting, body-file safety, traceability, and one\n  delivery regression\n\n### github-product-manager\n\nBuilds product Goal Contracts from known evidence and asks only questions whose\nanswers can change outcome, scope, evaluation, or irreversible impact. Success\nsignals may use user scenarios, metrics, visual results, contracts, or tests;\n“all tests pass” is not a product outcome.\n\n### Skill Structure\n\n```\nskills/\n  using-devkit/\n    SKILL.md                    # Unified discovery and repository entry\n    assets/\n      project.example.json      # Copyable project parameter template\n    references/\n      level-decision.md         # L0-L3 depth scaling\n      language-stack.md         # Language/tool detection\n      project-profile.md        # .devkit/project.json discovery and schema\n      orchestration-cheatsheet.md\n      system-learning.md\n  sies-engineering/\n    SKILL.md                    # Goal-first engineering lifecycle\n    references/\n      evidence-strategy.md      # Evaluation, TDD selection, regression\n      github-state.md           # GitHub Goal/Evidence state\n  friendly-python/\n    SKILL.md                    # Main skill document\n    references/\n      fix-patterns.md           # Before/after fix examples\n      tool-codes.md             # Pyright/Pylint code reference\n      advanced-patterns.md      # Complex type patterns\n  humanizing-writing/\n    SKILL.md                    # Chinese/English writing workflow\n    references/\n      chinese-patterns.md\n      english-patterns.md\n  taste-skill/\n    SKILL.md                    # Context-aware web design\n  image-to-code-skill/\n    SKILL.md                    # Visual reference to frontend\n  imagegen-frontend-web/\n    SKILL.md                    # Image-only web references\n  imagegen-frontend-mobile/\n    SKILL.md                    # Image-only mobile flows\n  pptx/\n    SKILL.md                    # PowerPoint artifact workflow\n    references/\n      repository-reporting.md   # Traceable weekly/monthly/project reporting\n  deployment-operations/\n    SKILL.md                    # Deploy, diagnose, verify, and roll back\n    references/\n      deployment-playbook.md\n      incident-response.md\n  production-statistics/\n    SKILL.md                    # Safe production aggregate statistics\n    references/\n      read-only-database.md\n  mihomo-proxy-setup/\n    SKILL.md                    # Installation/uninstall flow\n    references/\n      config-templates.md       # Config files and script templates\n      systemd-units.md          # Linux systemd service units\n      launchd-plist.md          # macOS launchd plist files\n      troubleshooting.md        # Common issues and fixes\n  github-create-issue/\n    SKILL.md                    # Adaptive Issue creation\n    references/\n      issue-profiles.md\n  github-issue-workflow/\n    SKILL.md                    # Phase-aware Issue controller\n    references/\n      issue-sources.md\n  github-product-manager/\n    SKILL.md                    # Product Goal discovery\n    references/\n      question-framework.md\n      issue-template.md\n```\n\n## Updating\n\nRe-run the install script — it auto-detects existing installations and updates via `git pull`:\n\n```bash\n# macOS / Linux\ncurl -fsSL https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.sh | bash -s -- claude\n```\n\n```powershell\n# Windows\n& ([scriptblock]::Create((irm https://raw.githubusercontent.com/zhpeng24/devkit/main/scripts/install.ps1))) -Platform claude\n```\n\n<details>\n<summary>Manual update</summary>\n\n```bash\n# Claude Code\nclaude plugins update devkit\n\n# Cursor\ncd ~/.cursor/plugins/local/devkit && git pull\n\n# Copilot CLI\ncd ~/.copilot/plugins/devkit && git pull\n\n# Codex\ncd ~/.codex/devkit && git pull\n\n# OpenCode — restart OpenCode (auto-updates from git)\n\n# Gemini CLI\ngemini extensions update devkit\n```\n\n</details>\n\n## Contributing\n\n1. Fork the repository\n2. Create your skill in `skills/<skill-name>/SKILL.md`\n3. Submit a PR\n\n## License\n\nMIT License — see [LICENSE](LICENSE). Adapted components retain their original\nlicenses and attribution in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).\n",
  "bytes": 14557,
  "sha": "3a050c872bede24d8b375bcea3a125def4541b9604dec21dddfea0f1b21d1373",
  "repo_slug": "zhpeng24/devkit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_zhpeng24_devkit_9c86f2e0/readme"
}