Contributing

免責聲明

這一頁目前使用生成式 AI 撰寫與維護的臨時草稿。內容雖已確認正確，仍請對照原始碼再次查核。

Step-by-step guides for contributing code to TomoriBot. These assume you have the repository cloned and the source open: they extend or modify the bot itself.

Start with development-tasks.md for the task index and coding conventions, then jump to the guide for your task.

Local Setup

• getting-started.md: set up TomoriBot locally with Bun + PostgreSQL for development
• docs-authoring.md: docs routes, frontmatter, sidebar, cards, and asset conventions

Adding Things

• adding-slash-command.md
• adding-event-handler.md
• adding-builtin-tool.md
• adding-feature-flag-tool.md
• adding-setup-module.md
• adding-db-column.md
• adding-new-provider.md
• adding-locale/: Discord locale codes, UI strings, frozen protocol keys, seed descriptions, docs and README scope, and the per-locale gate sequence
• docs-site-localization.md: docs routes, locale config, hreflang, and translated READMEs
• adding-persona-preset.md
• adding-env-variable.md

Testing Your Changes

• testing-db-changes.md
• testing-chat-changes.md
• testing-module-mocks.md

Conventions and Policies

• comment-policy.md: durable comments and the advisory policy audit
• panel-prose-and-layout.md: text width, markers, and structure inside a panel
• raw-sql-boundary.md: keeping raw SQL in the repository layer
• dependency-security-policy.md: overrides, patches, and audit exceptions