AsiaOstrich Audit Assistant | 審計助手
Language: English | 繁體中文
Version: 1.0.0 Last Updated: 2026-03-04
Diagnose UDS installation health, detect development patterns worth standardizing, identify friction with existing standards, and submit structured feedback to the UDS repository.
診斷 UDS 安裝健康狀態、偵測值得規範化的開發模式、識別與現有標準的摩擦點，並向 UDS 儲存庫提交結構化回饋。
Workflow | 工作流程
DIAGNOSE ──► ANALYZE ──► REPORT
診斷健康 分析模式 回報回饋
Phase 1: DIAGNOSE | 診斷
Run health check on UDS installation.
執行 UDS 安裝健康檢查。
| Check | Description | 檢查項目 |
|---|---|---|
.standards/ exists |
Verify directory and files | 驗證目錄與檔案 |
manifest.json valid |
Parse and validate manifest | 解析驗證 manifest |
| File integrity | Compare hashes against manifest | 比對雜湊與 manifest |
| AI config references | Verify AI config files reference .standards/ |
驗證 AI 設定檔引用 |
Phase 2: ANALYZE | 分析
Detect patterns and friction points.
偵測模式與摩擦點。
| Analysis | Method | 分析方法 |
|---|---|---|
| Directory patterns | Scan for known standard categories | 掃描已知標準類別 |
| Commit patterns | Analyze recent 100 commits for recurring topics | 分析近 100 筆 commit |
| Modified standards | Compare file hashes (diff-based) | 比對檔案雜湊 |
| Unused standards | Check AI config references | 檢查 AI 設定引用 |
| Orphaned files | Find untracked files in .standards/ |
找出未追蹤檔案 |
Phase 3: REPORT | 回報
Submit findings as structured GitHub issue.
將發現以結構化 GitHub issue 提交。
| Method | Condition | 方法 |
|---|---|---|
gh issue create |
gh CLI installed |
gh CLI 已安裝 |
| Browser deeplink | Fallback to pre-filled URL | 退回至預填 URL |
| Clipboard copy | Last resort | 最終手段複製至剪貼簿 |
Usage | 使用方式
# Full audit (all layers)
uds audit
# Health check only
uds audit --health
# Pattern detection only
uds audit --patterns
# Friction detection only
uds audit --friction
# JSON output
uds audit --format json
# Summary only (for scripts)
uds audit --quiet
# Submit feedback interactively
uds audit --report
# Preview report without submitting
uds audit --report --dry-run
Integration with Other Skills | 與其他技能的整合
When suggested by other skills (e.g., /checkin, /commit, /code-review, /sdd), /audit can be invoked to:
當被其他技能建議時，/audit 可根據情境執行針對性的檢查：
| Context | Recommended Command | 情境 |
|---|---|---|
After /checkin failure |
/audit --health |
checkin 失敗後診斷 |
After /commit |
/audit --report |
提交後回報發現 |
After /code-review finds friction |
/audit --friction |
審查發現摩擦時 |
After /sdd spec creation |
/audit --patterns |
規格建立後檢查覆蓋率 |
Next Steps | 後續步驟
After running audit:
| Finding | Action | 建議動作 |
|---|---|---|
| Health ERROR ⭐ Recommended / 推薦 | Run uds init or uds check --restore |
執行修復指令 |
| Pattern detected | Consider requesting new standard via --report |
考慮透過 --report 請求新標準 |
| Modified standard | Review if standard needs more flexibility | 檢視標準是否需要更多彈性 |
| Unused standard | Consider removing with uds uninstall |
考慮移除未使用標準 |
Related Standards | 相關規範
- checkin-standards — Code check-in requirements
- testing-standards — Testing requirements
Version History | 版本歷史
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-03-04 | Initial release — three-layer audit system |
License
CC BY 4.0 — See LICENSE for details.