boost-skills 是做什麼的？
Sander Muller 個人以 Composer 分發的 AI 代理技能目錄，專為 PHP 專案和 Composer 套件設計。若您的偏好與 Sander 一致，可採用此目錄；或將其作為自訂目錄的範本。
sandermuller/boost-skills 是一個以 Composer 分發的 AI 技能目錄範例。它提供一個精心挑選的技能組合，包含通用工作流程技能（程式碼審查、錯誤修復、規格驅動實作、發佈檢查清單、Jira 工作流程、部署等）、依標籤過濾的框架專屬擴充功能，以及始終啟用的準則—請參閱下方的完整技能與準則清單。
此套件不包含任何執行時期程式碼，僅為純 Markdown。同步引擎（sandermuller/boost-core 或 laravel/boost）會讀取這些技能，並將其寫入您已設定的每個 AI 代理目錄（Claude Code、Cursor、Copilot、Codex、Gemini 等）。
技能來源為何？
可來自任何您想要的地方。技能來源可堆疊使用—自由混合搭配：
- 您專案內建的
.ai/skills/資料夾，手動撰寫於專案旁。laravel/boost和boost-core都會自動識別此慣例。 - 透過 Composer 安裝的目錄套件。任何包含
resources/boost/skills/的套件都可使用。Sander 在sandermuller/boost-skills（此儲存庫）發佈他的個人目錄—若您的偏好與 Sander 一致，可採用此目錄；或將其作為您私人/公開目錄的範本。 - 透過
boost-core的withRemoteSkills()使用外部非 Composer 來源。可直接從 URL 拉取 GitHub 上發佈的.skill套件或單一技能儲存庫。 laravel/boost內建的 Laravel 技能—由 Laravel 透過laravel/boost提供的 Laravel 專屬技能（僅限 Laravel 應用程式）。
withAllowedVendors() 僅限用於透過 Composer 掃描的供應商（來源 2）。withTags() 會過濾來源 2、3 和 4（Composer 供應商、遠端技能、laravel/boost 套件）。內建的 .ai/skills/（來源 1）會繞過兩個過濾條件—您的專案撰寫了那些技能，因此引擎將其視為權威內容，不套用任何過濾器。
boost 系列
若您採用 sandermuller/boost-skills（或任何以 Composer 分發的目錄），請將其與符合您角色的同步引擎配對：
sandermuller/package-boost-php—若您編寫與框架無關的 Composer 套件sandermuller/package-boost-laravel—若您編寫 Laravel 套件sandermuller/project-boost-php—若您建構 PHP 應用程式sandermuller/project-boost-laravel—若您建構 Laravel 應用程式（可與laravel/boost共存—新增九代理扇出、標籤過濾、供應商允許清單、遠端技能）
四個 sandermuller/* 套件都捆綁了 sandermuller/boost-core 同步引擎，因此您通常不需要自行安裝 boost-core。laravel/boost（Laravel 自家的引擎、MCP 伺服器和文件 API）可與 Laravel 應用程式中的 project-boost-laravel 共存—系列套件在其上層新增了九代理扇出和過濾功能。若您想跳過系列控制，單獨使用 laravel/boost，它同樣可以讀取任何以 Composer 分發的目錄（包括此目錄）；請依照其設定進行。boost-core 原本會內嵌的專案慣例插槽在 laravel/boost 下仍可正常讀取—這些技能帶有可見的預設值（請參閱專案慣例結構），因此即使 laravel/boost 未解析插槽，您仍能獲得合理的預設用語。如果以上選項都不適合（例如非 PHP 套件），請直接安裝 boost-core。
安裝
若您採用 sandermuller/boost-skills 作為目錄，請將其與符合您引擎角色的系列套件一起安裝。對於與框架無關的套件作者，這是 package-boost-php：
composer require --dev sandermuller/boost-skills sandermuller/package-boost-php
將 package-boost-php 替換為 package-boost-laravel 或 project-boost 以符合您的角色。以下步驟使用 boost-core 引擎的命令；若使用 laravel/boost，請改為依照其自身的設定，並確保 sandermuller/boost-skills 在其同步的套件清單中。
系列套件會引入 boost-core，它附帶一個互動式安裝命令：
vendor/bin/boost install
boost install 會在您的專案根目錄產生一個 boost.php 檔案，並讓您選擇目標代理和允許清單中的供應商。技能僅從允許清單中的供應商同步，因此請確保選取了 sandermuller/boost-skills。結果如下所示：
return BoostConfig::configure()
->withAgents([
Agent::CLAUDE_CODE,
Agent::COPILOT,
Agent::CODEX,
])
->withAllowedVendors([
'sandermuller/boost-skills',
'sandermuller/package-boost-php',
])
->withTags(['php', 'github']);
在 ->withTags(...) 中宣告您專案的能力—僅有帶有對應標籤的技能和準則會同步到選擇加入的專案。常見的起手標籤包括 'php' 和 'github'；請參閱標籤註冊表以了解完整詞彙。同步後，執行 vendor/bin/boost tags 會顯示目前被過濾掉的標籤內容與已同步的內容—方便您發現可能需要宣告的能力。
然後將技能展開：
vendor/bin/boost sync
編輯後重新同步請執行 vendor/bin/boost sync，或將 BoostAutoSync 回呼 加入您的 composer.json 的 post-install-cmd / post-update-cmd，以便在每次 composer install / composer update 時自動重新同步。產生的代理目錄（.claude/skills/、.github/skills/ 等）應保留在版本控制之外；boost-core 會管理該 .gitignore 區塊。
技能
| 技能 | 功能說明 | 標籤 |
|---|---|---|
ai-guidelines | 建立和維護 AI 技能與準則檔案（.ai/、CLAUDE.md、AGENTS.md）。 | — |
autoresearch | 自主效能循環：基準測試、修改程式碼，然後根據測量結果保留或還原。 | php |
backend-quality | 兩層 PHP 品質閘道：每次變更時執行 Pint 及相關測試，完成時執行 PHPStan 及完整測試套件。 | php |
bug-fixing | 測試驅動的錯誤工作流程：先用失敗的測試重現問題，然後修復它。 | — |
code-review | 從功能、程式碼品質、安全性和測試等面向審查最近的變更。 | — |
codex-review | 請求 OpenAI Codex CLI 進行獨立審查，套用適當的修正，並重新審查直到無誤。 | — |
deploying-laravel-cloud | 透過 cloud CLI 在 Laravel Cloud 上部署和管理 Laravel 應用程式—環境、資料庫、網域、帳務。 | laravel-cloud hosting |
eloquent-models | 建立和維護包含欄位/關聯常數、詳盡 docblock 以及外鍵常數的 Eloquent 模型。 | laravel |
evaluate | 自我審查完整實作，並修復其發現的問題。 | — |
final-verification-review | 結案判定：執行完整的評估循環，乾執行結案預檢（PR 流程或無 PR 的提交/發佈），報告 READY / NOT READY。 | github |
frontend-quality | 前端品質閘道：型別檢查、程式碼檢查以及 JS 測試套件；針對 UI 變更提供目視驗證建議。 | frontend |
github-issue-updates | 功能上線後，將使用者可見的說明和 QA 可測試項目附加到 GitHub Issue 中。 | github-issues |
humanizer | 移除 AI 生成內容的痕跡，使文字讀起來自然且人性化。 | — |
implement-spec | 依照規格檔案，分階段實作並追蹤進度。 | — |
interview | 以對抗性方式深入挖掘複雜功能的需求—程式碼優先、假設審查—在撰寫規格之前完成。 | — |
jira-create | 建立一個格式良好、使用者可見的 Jira 問題。 | jira |
jira-rework | 研究被退回修改的 Jira 問題，然後提出修正選項。 | jira github |
jira-updates | 在 PR 建立後更新 Jira 問題；發佈標記為「受阻-待釐清」的評論。 | jira github |
migration-squash | 安全地建立或審查 Laravel 遷移壓縮—預先檢查匯出內容，然後檢查清單以捕捉不完整、受污染或會遺失資料的基準線。 | laravel |
pr-review-feedback | 套用 PR 審查意見，在執行前逐一關鍵評估。 | github |
pre-release | 推送前的全面檢查：Rector、Pint、完整測試套件、PHPStan 以及文件時效性審計。 | php github |
pull-requests | 透過 gh 建立和管理您自己的 GitHub PR：撰寫說明、驗證、根據風險分流。 | github |
readme | 為 Composer 套件撰寫和維護高品質的 README—範本與完整版、語氣、時效性審計。 | release-automation |
release-notes | 為 Composer 套件起草 GitHub 發佈說明—結構、語氣、重大變更標註、應省略的內容。 | release-automation |
resolve-conflicts | 解決 git 合併衝突，不遺失任一端的功能。 | — |
test-writing | 撰寫特定、描述性名稱的測試，並遵循 Arrange-Act-Assert 模式。 | — |
upgrading | Composer 套件中 UPGRADING.md 的規範結構—何時維護、應包含哪些內容。 | release-automation |
ux-review | 評估新功能的 UX/UI 選項，建議一種方法，並記錄決策。 | — |
write-spec | 撰寫可供實作的規格檔案，並包含可追蹤進度的階段。 | — |
標籤
大多數技能和準則是通用的—它們會同步到每個專案。部分技能和準則帶有能力標籤，用來指明專案需要（或選擇加入）哪些能力才能使這些內容實用。專案在 boost.php 中透過 ->withTags(...) 宣告其能力，只有匹配的內容才會同步。
標籤機制（子集 AND 比對、boost.php 中的 withTags() 宣告、技能 frontmatter 中的 metadata.boost-tags、準則的 .boost-tags.yaml 附帶清單）是系列套件的標準規範—由 boost-core 定義，並適用於任何以 Composer 分發的目錄。下面的標籤詞彙是此目錄的選擇—Sander 混合了 boost-skills 所提供技能和準則所涵蓋的能力。其他目錄可能會有不同的組織方式。擁有者則指出每個標籤所對應的內容是由哪個 boost 系列套件提供。
boost-core 提供了一個更廣泛的 Tag 列舉（SanderMuller\BoostCore\Enums\Tag），其中包含此目錄中未與任何技能綁定的案例—Tag::Filament、Tag::Livewire、Tag::Volt、Tag::Inertia、Tag::Flux、Tag::Pest、Tag::Tailwind 等。這些是系列詞彙中的前瞻相容插槽。在您的 withTags(...) 中宣告它們目前是無害的（尚無已提供的技能以此為目標），並且根據 boost-core 的「已宣告但未發現」保留規則，它們能在 boost install 選擇器重新執行時存活下來。下表僅涵蓋 boost-skills 本身目前提供內容的標籤；請參閱 boost-core 中的 Tag::* 以了解完整的列舉詞彙。
| 標籤 | 意義 | 擁有者 |
|---|---|---|
boost-extension | 選擇加入—擴充 boost-core（自訂技能 + FileEmitters） | package-boost-php |
database | 專案有資料庫 | boost-skills |
frontend | 前端工具鏈—型別檢查、程式碼檢查、JS 測試 | boost-skills |
github | 託管於 GitHub | boost-skills |
github-issues | 在 GitHub Issues 中追蹤問題 | boost-skills |
hosting | 專案部署至託管平台（平台特定標籤的父標籤） | boost-skills |
jira | 在 Jira 中追蹤問題 | boost-skills |
laravel |
…
[為翻譯而截斷]