{"id":49115771,"url":"https://github.com/hottim900/quality-tracker","last_synced_at":"2026-04-21T07:07:51.326Z","repository":{"id":345779063,"uuid":"1187337269","full_name":"hottim900/quality-tracker","owner":"hottim900","description":"AI 輔助開發的品質追蹤系統模板 — 搜查手冊驅動，搭配 Claude Code 使用","archived":false,"fork":false,"pushed_at":"2026-04-06T10:31:58.000Z","size":129,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T12:20:53.351Z","etag":null,"topics":["ai-assisted-development","anthropic","bug-tracking","claude-code","code-quality","defect-tracking","developer-tools","github-template","markdown","quality-assurance","tech-debt","template"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hottim900.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-20T15:58:34.000Z","updated_at":"2026-04-06T10:32:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hottim900/quality-tracker","commit_stats":null,"previous_names":["hottim900/quality-tracker"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/hottim900/quality-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hottim900%2Fquality-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hottim900%2Fquality-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hottim900%2Fquality-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hottim900%2Fquality-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hottim900","download_url":"https://codeload.github.com/hottim900/quality-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hottim900%2Fquality-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32081145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T06:27:27.065Z","status":"ssl_error","status_checked_at":"2026-04-21T06:27:21.250Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assisted-development","anthropic","bug-tracking","claude-code","code-quality","defect-tracking","developer-tools","github-template","markdown","quality-assurance","tech-debt","template"],"created_at":"2026-04-21T07:07:50.669Z","updated_at":"2026-04-21T07:07:51.320Z","avatar_url":"https://github.com/hottim900.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# quality-tracker\n\n為 AI 輔助開發設計的品質追蹤系統。搭配 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 使用。\n\n追蹤四種品質項目：**Defect**（非預期 bug）、**Tech Debt**（有意識的妥協）、**Feature Gap**（功能缺口）、**Test Infrastructure**（測試覆蓋與工具建設），搭配系統性搜查手冊，讓 AI 能自主發現、記錄、修復品質問題。\n\n品質項目以 **GitHub Issues / GitLab Issues** 追蹤，透過結構化 label 管理 metadata。核心價值是兩層品質發現機制：**搜查手冊（Defect Taxonomy）** 的 grep 搜查模式，加上**探索式測試（ET）** 引導人類探索 grep 搜不到的業務邊界和意圖判斷問題。\n\n---\n\n## 為什麼需要這個？\n\nAI 輔助開發常見的品質問題：\n\n- **改完原始碼忘更新追蹤** — AI 修完 bug 但忘記更新追蹤項目狀態、檢查相依項目\n- **同類 bug 反覆出現** — 修了一個 bare catch，但不知道同類問題還有 12 處\n- **缺乏系統性搜查** — 靠肉眼或記憶找 bug，而非可重複執行的搜查指令\n\n本系統用**雙層發現機制**解決這些問題：搜查手冊定義缺陷類別 + 可執行的 grep 指令，探索式測試（ET）用輕量 charter 引導人類探索 grep 無法覆蓋的問題。兩者互饋：ET 發現的新 pattern 可加入搜查手冊，搜查手冊的盲區產生 ET 探索目標。\n\n---\n\n## 快速開始\n\n### 1. 從 template 建立你的品質 repo\n\n點選 GitHub 的 **\"Use this template\"** 按鈕，建立你的 private repo。\n\n### 2. 安裝 Issue/PR 模板和 Labels\n\n根據你的平台執行對應的 setup script：\n\n```bash\n# GitHub\nbash integrations/setup-github.sh\n\n# GitLab\nbash integrations/setup-gitlab.sh\n```\n\n\u003e 前置需求：`gh` 或 `glab` CLI 已安裝且已認證，以及 `jq`。\n\n### 3. 設定 Claude Code Skill\n\n將 `.claude/skills/quality/` 複製到你的專案，然後編輯 `SKILL.md` 頂部：\n\n```\nQUALITY_DIR=/你的品質系統絕對路徑/quality\n```\n\n\u003e **為什麼要絕對路徑？** Claude Code 可能在 git worktree 中執行，相對路徑會指向 worktree 而非品質系統。\n\n### 4. 在 CLAUDE.md 加入入口\n\n將 `CLAUDE.md.snippet` 的內容貼進你專案的 `CLAUDE.md`。\n\n### 5. 跑首次搜查\n\n在 Claude Code 中：\n\n```\n/quality\n```\n\n然後請 Claude 對你的 codebase 執行搜查手冊中的類別，從 D-SILENT（靜默失敗）開始。\n\n---\n\n## 系統組成\n\n```\nquality/\n├── README.md                      ← 系統參考：分類定義、Label 參考、查詢指引\n├── defect-taxonomy.md             ← 搜查手冊：6 個缺陷類別 + charter seed + 擴充指引\n├── discovery-strategy.md          ← 雙層發現模型：grep 搜查 + 探索式測試 (ET)\n├── et-charter-template.md         ← ET Charter 模板：4T 欄位 + Quick Start\n└── quality-system-design-notes.md ← 方法論：設計原則、取捨、AI 效率優化\n\nintegrations/\n├── github/                        ← GitHub Issue/PR 模板（YAML forms）\n├── gitlab/                        ← GitLab Issue/MR 模板（markdown）\n├── labels.json                    ← Label 定義（single source of truth）\n├── setup-github.sh                ← GitHub 安裝腳本\n└── setup-gitlab.sh                ← GitLab 安裝腳本\n```\n\n| 組件          | 說明                                                                         |\n| ------------- | ---------------------------------------------------------------------------- |\n| **系統參考**  | 分類決策樹、定義參考、Label 參考、完成步驟。                                |\n| **Issue 模板**| 四種 Issue 模板（Defect / Tech Debt / Feature Gap / Test Infrastructure），各有專屬 metadata 欄位。 |\n| **搜查手冊**  | 6 個內建缺陷類別，各附 grep 搜查指令和 ET charter seed。可自行擴充。         |\n| **ET 框架**   | 雙層發現策略、Charter 模板（4T 欄位）、互饋迴圈、pattern 推廣標準。          |\n| **Skill**     | Claude Code 的操作指南，讓 AI 知道如何操作整個系統（含 ET session 建議）。    |\n\n---\n\n## 工作流\n\n```\n發現問題\n    │\n    ▼\n判斷分類（決策樹，依序判斷）\n    │\n    ├─ 有意識的妥協？\n    │   ├─ 測試面？ → Test Infrastructure\n    │   └─ 其他？ → Tech Debt\n    ├─ 行為與意圖不符？ → Defect\n    └─ 功能不完整？\n        ├─ 測試覆蓋缺口？ → Test Infrastructure\n        └─ 其他？ → Feature Gap\n    │\n    ▼\n建立 Issue（用 Issue 模板 → 加 label）\n    │\n    ▼\n修復 → PR/MR（含缺陷掃查）\n    │\n    ▼\n關閉 Issue（完成 comment → 檢查相依 → 更新 taxonomy）\n```\n\n---\n\n## 版本控制\n\n品質追蹤資料可能包含安全漏洞的詳細描述，需要考慮隔離。\n\n### 模式 A：Companion Repo（建議）\n\n品質系統（搜查手冊 + 設計文件）作為獨立的 private repo。品質 Issues 建立在 **project repo**（程式碼所在的 repo），因為 Issue 與程式碼緊密關聯。\n\n- 搜查手冊中的搜查結果用 `owner/project-repo#N` 格式引用 project repo 的 Issue\n- **優點**：搜查手冊和方法論獨立版控，可套用到多個專案\n- **適用**：品質方法論需要跨專案共用、或搜查手冊需要保密的場景\n\n### 模式 B：Collocated\n\n品質目錄直接在主專案 repo 內。Issues 自然在同一個 repo。\n\n- 搜查結果用 `#N` 格式引用 Issue（自動連結）\n- **優點**：簡單、一個 repo 管理所有\n- **適用**：開源專案、品質資料不需保密的場景\n\n---\n\n## 進階\n\n### 自定義搜查類別\n\n內建 6 個通用類別（D-SILENT、D-VALID、D-AUTH、D-TYPE、D-PERF、D-EDGE），每個都附有 grep 搜查指令和 ET charter seed（grep 搜不到的盲區描述）。可根據你的技術棧擴充。詳見搜查手冊底部的「[如何新增自定義類別](./quality/defect-taxonomy.md#如何新增自定義類別)」。\n\n### Hook 整合\n\n用 Claude Code 的 PostToolUse hook 自動化品質防線。範例見 [`examples/hooks/`](./examples/hooks/)：\n\n- **migration-safety.sh** — Migration 程式碼安全檢查（阻擋危險操作）\n\n### 統計腳本\n\n`bash examples/scripts/quality-stats.sh --github` — 透過 `gh`/`glab` CLI 查詢 Issues，輸出各類別/優先級/狀態的統計報告。\n\n\u003e 前置需求：`gh` 或 `glab` CLI 已認證、網路連線。\n\n### 方法論\n\n本系統基於 ODC、DORA、Shift-Left Testing 等業界實踐設計。詳見 [`quality/quality-system-design-notes.md`](./quality/quality-system-design-notes.md)。\n\n---\n\n## 實戰範例\n\n不同技術棧的搜查手冊範例，展示如何將通用方法論適配到具體專案：\n\n- [`examples/sparkle/`](./examples/sparkle/) — **TypeScript / Bun / SQLite**（Sparkle PKM）：3 輪系統性搜查、38 項追蹤、12 類缺陷分類。含 [ET charter 執行範例](./examples/sparkle/et-charters.md)。\n- [`examples/dotnet/`](./examples/dotnet/) — **.NET Clean Architecture + EF Core + React**：13 個缺陷類別，涵蓋 EF Core 配置、異常語意、授權 IDOR、前端 cache invalidation 等 .NET 專案常見問題。\n\n\u003e 上述範例使用舊的 `[DEF-NNN](path)` 檔案連結格式。Issue-native 模式下改用 `#N`（collocated）或 `owner/repo#N`（companion repo）格式。\n\n## 授權\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhottim900%2Fquality-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhottim900%2Fquality-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhottim900%2Fquality-tracker/lists"}