AsiaOstrich 簽入助手
語言: English | 繁體中文
⚠️ 狀態：參考用（非可執行流程） — 簽入流程協調（關卡執行序列、abort 邏輯）已於 2026-04-28 移至 adoption layer（XSPEC-095）。此處保留品質關卡定義、檢查清單項、never-commit 規則供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
在提交程式碼前驗證品質關卡，確保程式碼庫的穩定性。
工作流程
- 檢查 git 狀態 - 執行
git status和git diff了解待提交的變更 - 執行測試 - 執行
npm test（或專案測試指令）驗證所有測試通過 - 執行程式碼檢查 - 執行
npm run lint檢查程式碼風格合規 - 驗證品質關卡 - 根據以下清單逐項檢查
- 報告結果 - 呈現通過/失敗摘要並建議後續步驟
品質關卡
| 關卡 | 檢查項目 | Check |
|---|---|---|
| 建置 | 編譯零錯誤 | Code compiles with zero errors |
| 測試 | 所有測試通過（100%） | All existing tests pass |
| 覆蓋率 | 覆蓋率未下降 | Test coverage not decreased |
| 程式碼品質 | 符合編碼規範、無程式碼異味 | Follows coding standards |
| 安全性 | 無硬編碼密鑰或漏洞 | No hardcoded secrets |
| 文件 | API 文件和 CHANGELOG 已更新 | Documentation updated |
| 工作流程 | 分支命名和提交訊息格式正確 | Branch naming and commit correct |
| 上游檔案 | .standards/ 或 .claude/skills/ 無修改（建議性） |
No UDS upstream file modifications (advisory) |
禁止提交的情況
- 建置有錯誤 | Build has errors
- 測試失敗 | Tests are failing
- 功能不完整會破壞現有功能 | Feature is incomplete and would break functionality
- 關鍵邏輯中有 WIP/TODO | Contains WIP/TODO in critical logic
- 包含除錯程式碼（console.log、print） | Contains debugging code
- 包含被註解的程式碼區塊 | Contains commented-out code blocks
使用方式
/checkin- 對目前變更執行完整品質關卡驗證- 驗證通過後，使用
/commit建立 commit message
下一步引導
/checkin 完成後，AI 助手應建議：
品質關卡驗證完成。建議下一步：
- 全部通過 ✅ → 執行
/commit提交變更- 有失敗項目 ❌ → 修復問題後重新執行
/checkin- 需要程式碼審查 → 執行
/code-review進行自我審查- UDS 安裝有異常 → 執行
/audit診斷問題
參考
- 詳細指南：guide.md
- 核心規範：checkin-standards.md