pma-bun

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bun Project Implementation Guide

Bun项目实现指南

Use this skill together with
/pma
.
/pma
controls workflow, approval, and task tracking; this guide defines the implementation baseline after approval.
Keep this entry file small. Load only the relevant reference packs.
本Skill需配合
/pma
一起使用。
/pma
用于管控工作流、审批和任务追踪;本指南定义了审批后的实现基线。
请保持这个入口文件精简,仅加载相关参考包。

Scope

适用范围

For PMA-managed Bun backends, API services, CLIs, and Bun-based full-stack projects.
Not for frontend-only SPAs, Node-specific runtime guides, or non-PMA workflows.
适用于PMA管理的Bun后端、API服务、CLI工具,以及基于Bun的全栈项目。
不适用于仅前端的单页应用、Node专属运行时指南,或非PMA工作流。

Loading Order

加载顺序

  1. Always load
    references/baseline.md
    first.
  2. Load
    references/runtime.md
    for app bootstrap, config, HTTP server, docs, logging, and compiled-binary concerns.
  3. Load
    references/data-and-testing.md
    for Drizzle, bun:sqlite, PostgreSQL, repository patterns, and testing.
  4. Load
    references/delivery.md
    for lint, TypeScript, hooks, observability, CI, Docker, security, and Git workflow.
  1. 始终优先加载
    references/baseline.md
  2. 若涉及应用启动、配置、HTTP服务、文档、日志、二进制编译相关内容,加载
    references/runtime.md
  3. 若涉及Drizzle、bun:sqlite、PostgreSQL、仓储模式、测试相关内容,加载
    references/data-and-testing.md
  4. 若涉及代码检查、TypeScript、钩子、可观测性、CI、Docker、安全、Git工作流相关内容,加载
    references/delivery.md

Quick Routing

快速跳转

  • New service setup or repo restructuring:
    references/baseline.md
  • OpenAPIHono, config, startup, graceful shutdown, logging, compiled binaries:
    references/runtime.md
  • Schema design, migrations, drivers, repositories, test setup:
    references/data-and-testing.md
  • Quality gates, lint, TypeScript, security, observability, CI, Docker, PR readiness:
    references/delivery.md
  • 新服务搭建或仓库重构:
    references/baseline.md
  • OpenAPIHono、配置、启动、优雅关闭、日志、编译二进制:
    references/runtime.md
  • 库表设计、数据迁移、驱动、仓储层、测试配置:
    references/data-and-testing.md
  • 质量门禁、代码检查、TypeScript、安全、可观测性、CI、Docker、PR准入:
    references/delivery.md

Reference Packs

参考包

  • references/baseline.md
    Scope, stack defaults, required quality gates, project layout, conventions, code quality, and implementation workflow.
  • references/runtime.md
    Formatting and TypeScript defaults, config loading, error handling, OpenAPIHono setup, logging, API docs, and single-binary delivery.
  • references/data-and-testing.md
    Drizzle with bun:sqlite, PostgreSQL alternative, repository boundaries, and testing rules.
  • references/delivery.md
    Hooks, security patterns, observability, CI pipeline, Docker, workspace rules, and Git conventions.
If the repository intentionally diverges, keep the deviation explicit in the proposal and consistent across scripts, docs, and CI.
  • references/baseline.md
    适用范围、技术栈默认配置、必填质量门禁、项目结构、约定、代码质量、实现工作流。
  • references/runtime.md
    格式化与TypeScript默认配置、配置加载、错误处理、OpenAPIHono搭建、日志、API文档、单二进制交付。
  • references/data-and-testing.md
    结合bun:sqlite使用Drizzle、PostgreSQL替代方案、仓储边界、测试规则。
  • references/delivery.md
    钩子、安全模式、可观测性、CI流水线、Docker、工作区规则、Git约定。
若仓库有意偏离本规范,请在提案中明确说明差异,并保证脚本、文档、CI的配置保持一致。