Skip to main content

AsiaOstrich/universal-dev-standards

最近记录的来源活动
SkillsMP 收录数据更新
已收集 skills
272
GitHub 星标
84
GitHub Forks
13

用 AI 助手安装

复制这段 Prompt,发给你正在使用的 AI 助手。

正在加载仓库 README…

已展示 40 / 272 个已收集 Skill。

职业分类
未分类
描述

[UDS] 選用的小幫手,幫忙追蹤跨工作階段仍未完成的工作:便宜的收件點、每個等待都有解除條件、下一步點名真實的東西。 Use when: 工作在工作階段之間漏掉、某個項目「等待中」好幾天卻沒人知道在等什麼、「下一步」只寫「繼續」。 Not for: 已經用議題追蹤器或看板管理工作而且沒有漏掉東西的專案;規劃功能——請用 /plan 或 /sdd。 Keywords: open work, backlog, inbox, waiting, release condition, next action, 開放工作,…

更新
职业分类
未分类
描述

[UDS] 选用的小助手,帮助追踪跨会话仍未完成的工作:便宜的收件点、每个等待都有解除条件、下一步点名真实的东西。 Use when: 工作在会话之间漏掉、某个项目「等待中」好几天却没人知道在等什么、「下一步」只写「继续」。 Not for: 已经用 issue 追踪器或看板管理工作而且没有漏掉东西的项目;规划功能——请用 /plan 或 /sdd。 Keywords: open work, backlog, inbox, waiting, release condition, next action,…

更新
职业分类
未分类
描述

[UDS] 選用的小幫手,幫忙追蹤跨工作階段仍未完成的工作:便宜的收件點、每個等待都有解除條件、下一步點名真實的東西。 Use when: 工作在工作階段之間漏掉、某個項目「等待中」好幾天卻沒人知道在等什麼、「下一步」只寫「繼續」。 Not for: 已經用議題追蹤器或看板管理工作而且沒有漏掉東西的專案;規劃功能——請用 /plan 或 /sdd。 Keywords: open work, backlog, inbox, waiting, release condition, next action, 開放工作,…

更新
职业分类
未分类
描述

[UDS] Optional help for work that stays open across sessions: a cheap capture point, a release condition for every wait, a next step that names something real. Use when: work gets lost between sessions, an item has "waited" for days with no known reason, a…

原文语言:英语

更新
职业分类
未分类
描述

[UDS] 分析驗收條件(AC)與測試之間的追蹤關係,並產生需求層級的覆蓋率報告。 Use when: 稽核哪些驗收條件已有測試、從 SPEC 檔建立追蹤矩陣、發布前找出尚未被覆蓋的 AC。 Not for: 程式碼層級的行/分支/函式覆蓋率——請用 /coverage;補寫缺少的測試——請用 /tdd 或 /spec-derive。 Keywords: AC coverage, traceability, acceptance criteria, SPEC, traceability matrix, 驗收條件,…

更新
职业分类
未分类
描述

[UDS] 建立、管理並追蹤架構決策記錄(ADR)。 Use when: 架構決策、技術選型、設計取捨、模式選擇。 Not for: 不改變架構的決策——記在規格或 commit 裡即可;想法還沒成形到足以下決定——請用 /brainstorm。 Keywords: ADR, architecture decision, decision record, trade-off, 架構決策, 決策記錄, 設計取捨.

更新
职业分类
未分类
描述

防止 AI 幻覺,確保分析程式碼或提出建議時給出以證據為基礎的回應。 Use when: 分析程式碼、提出建議、提供選項,或使用者詢問把握度/確定性時。 Not for: 撰寫 AI 指令檔本身——請用 /ai-instruction-standards;審查具體的 diff——請用 /code-review。 Keywords: certainty, assumption, inference, evidence, source, 證據, 假設, 推論, 確定性, 反幻覺.

更新
职业分类
未分类
描述

設計 AI 友善架構,包含明確的模式、分層文件與語意邊界。 Use when: 為 AI 協作規劃專案結構、最佳化程式碼庫以利 AI 分析、建立 AI 上下文。 Not for: 撰寫指令檔本身——請用 /ai-instruction-standards;依語言慣例安排目錄配置——請用 /project-structure-guide。 Keywords: architecture, AI-friendly, context, modules, documentation layers,…

更新
职业分类
未分类
描述

建立並維護 AI 指令檔(CLAUDE.md、AGENTS.md、.cursor/rules/ 等),並採用適當結構。 Use when: 建立 AI 指令檔、區分通用規則與專案特定規則、設定 AI 工具。 Not for: 調整程式碼庫結構讓 AI 好導覽——請用 /ai-friendly-architecture;要求以證據為基礎的回答——請用 /ai-collaboration-standards。 Keywords: CLAUDE.md, AGENTS.md, cursorrules,…

更新
职业分类
未分类
描述

引導 API 設計,遵循 REST、GraphQL 與 gRPC 最佳實踐。 Use when: 設計 API、審查端點、API 版本策略決策。 Not for: 驗證運行中的 API 是否符合消費端期待——請用 /contract-test;API 背後的 schema 設計——請用 /database。 Keywords: API, REST, GraphQL, gRPC, endpoint, versioning, 介面設計, 端點, 版本策略.

更新
职业分类
未分类
描述

[UDS] 驗收測試驅動開發(ATDD)的參考資料:INVEST 準則、Gherkin 驗收條件格式與 Three Amigos 結構。 Use when: 與 Product Owner 一起定義驗收條件、進行規格工作坊、用 INVEST 檢視使用者故事。 Not for: 執行 ATDD 生命週期或強制 PO 簽核關卡——該部分已移至採用層(XSPEC-095);撰寫單元測試——請用 /tdd。 Keywords: ATDD, acceptance test, acceptance criteria,…

更新
职业分类
未分类
描述

[UDS] 診斷 UDS 安裝的健康狀態,並向上游提交結構化回饋。 Use when: .standards/ 看起來壞掉或不同步、驗證 manifest 完整性、回報既有 UDS 標準用起來的摩擦點。 Not for: 稽核你自己應用程式的程式碼品質——請用 /metrics 或 /code-review;相依套件與機密掃描——請用 /scan。 Keywords: UDS audit, health check, manifest integrity, standards feedback,…

更新
职业分类
未分类
描述

[UDS] 行為驅動開發(BDD)的參考資料:Gherkin 的 Given-When-Then 格式與 Three Amigos 結構。 Use when: 撰寫或審查 .feature 場景、選定通用語言、針對行為進行探索式對話。 Not for: 執行 BDD 生命週期或 RED/GREEN 自動化——該部分已移至採用層(XSPEC-095);把 .feature 檔轉成 E2E 骨架——請用 /e2e。 Keywords: BDD, Gherkin, Given When Then, feature…

更新
职业分类
未分类
描述

[UDS] 在規格出現之前執行的結構化多角色腦力激盪,並附帶評分品質關卡。 Use when: 想法還很模糊、在敲定方向前探索替代方案、需要多樣性而不是第一個看似合理的答案。 Not for: 方向已經定了的工作規劃——請用 /plan 或 /sdd;記錄已經做成的決策——請用 /adr。 Keywords: brainstorm, ideation, divergence, convergence, persona ensemble, devil advocate, 腦力激盪, 發想, 發散收斂, 多角色.

更新
职业分类
未分类
描述

[UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。 Use when: 從 commit 歷史撰寫變更日誌條目、填寫 Unreleased 區段、將變更分類為 Added/Changed/Fixed。 Not for: 決定下一個版本號或執行發版——請用 /release;撰寫 commit message 本身——請用 /commit。 Keywords: changelog, CHANGELOG.md, Keep a Changelog, release…

更新
职业分类
未分类
描述

[UDS] 提交前品質關卡的參考資料:關卡定義、檢查清單項目,以及絕不可提交的規則。 Use when: 決定 commit 前必須通過哪些檢查、稽核專案實際強制了哪些品質關卡、確認是否已可簽入。 Not for: 執行關卡流程或中止 commit——該部分已移至採用層(XSPEC-095);找出並清除除錯殘留——請用 /sweep。 Keywords: check-in, pre-commit, quality gate, commit readiness, never commit, 簽入, 提交前檢查,…

更新
职业分类
未分类
描述

引導 CI/CD 管線的設計、設定與最佳化。 Use when: 建置管線、縮短建置時間、設定部署階段。 Not for: 沒有 CI/CD 平台的部署——請用 /deploy;版本號遞增與晉級——請用 /release。 Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署, 管線.

更新
职业分类
未分类
描述

[UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。 Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。 Keywords: code review, pull request review, review checklist,…

更新
职业分类
未分类
描述

[UDS] 產生符合 Conventional Commits 規範的 commit message,包含雙語格式。 Use when: 為已暫存的變更撰寫 commit message、選擇 type 與 scope、產出英文與中文並列的主旨與內文。 Not for: 判斷這份變更是否已可提交——請用 /checkin;把多個 commit 彙整成發布說明——請用 /changelog。 Keywords: commit message, Conventional Commits, feat, fix,…

更新
职业分类
未分类
描述

[UDS] 把一段難懂的 AI 輸出換成較好懂的形式:受控文字、Mermaid 圖、單檔 HTML 解說頁。所有形式都來自同一份大綱,所以形式會變,事實不會變。 Use when: AI 的說明、規格或程式碼解說太密、讀的人看不出該不該核准;非專業的人必須靠它做核准;想要它的圖或離線解說頁。 Not for: 寫新內容或加新分析——本技能只把既有的文字換形式;從原始碼產生文件——請用 /docgen;為專家讀者縮短文字——直接改寫即可。 Keywords: comprehension ladder,…

更新
职业分类
未分类
描述

[UDS] 引導 API 與微服務的合約測試策略。 Use when: API 合約、微服務、消費者驅動測試、提供者驗證。 Not for: 一開始的 API 介面設計——請用 /api-design;經由 UI 的使用者可見流程——請用 /e2e。 Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 合約測試, 消費者驅動, 提供者驗證.

更新
职业分类
未分类
描述

引導資料庫設計、遷移與查詢最佳化。 Use when: schema 設計、遷移規劃、查詢最佳化、索引策略。 Not for: 應用程式碼遷移或框架升級——請用 /migrate;資料之上的 API 合約——請用 /api-design。 Keywords: database, schema, migration, SQL, index, query, 資料庫, 遷移, 查詢, 索引策略.

更新
职业分类
未分类
描述

引導在沒有 CI/CD 平台(GitHub Actions/GitLab CI)的情況下完成可靠部署。 Use when: 部署到 VPS、離線隔離的伺服器,或任何沒有 CI/CD 基礎設施的環境。 Not for: 建立在 GitHub Actions 或 GitLab CI 上的管線——請用 /ci-cd;版本號遞增與發布晉級——請用 /release。 Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback,…

更新
职业分类
未分类
描述

[UDS] 為專案選擇並追蹤當前採用的開發方法論(SDD、BDD、TDD)。 Use when: 決定專案該遵循哪一套方法論、切換方法論、查詢目前方法論處於哪個階段。 Not for: 查詢某個開發階段該執行哪個指令——請用 /dev-workflow;執行方法論本身——請用 /sdd、/bdd 或 /tdd。 Keywords: methodology, SDD, BDD, TDD, phase tracking, methodology selection, 方法論, 開發方法選擇, 階段追蹤.

更新
职业分类
未分类
描述

[UDS] 從專案原始檔產生使用文件(速查表、參考手冊、使用指南)。 Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。 Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide;變更日誌條目——請用 /changelog。 Keywords: docgen, usage docs, cheatsheet, feature reference, generated…

更新
职业分类
未分类
描述

引導文件結構、內容需求與專案文件的最佳實踐。 Use when: 建立 README、撰寫文件、規劃 docs 目錄、專案初始設定、技術文件。 Not for: 從原始碼機械式產生文件——請用 /docgen;變更日誌條目——請用 /changelog。 Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 說明文件, 技術文件.

更新
职业分类
未分类
描述

[UDS] 引導容錯工作流程設計,包含檢查點、重試策略與回滾計畫。 Use when: 長時間執行的工作流程總是中途失敗、設計檢查點的粒度、選擇重試或退避策略。 Not for: 處理正在發生中的線上事故——請用 /incident;部署回滾的實作機制——請用 /deploy。 Keywords: durable execution, checkpoint, retry, backoff, idempotency, rollback, 持久執行, 檢查點, 重試策略, 冪等.

更新
职业分类
未分类
描述

[UDS] 從 BDD 的 .feature 場景產生 E2E 測試骨架,並支援框架偵測與覆蓋缺口分析。 Use when: 把已完成的 .feature 場景轉成可執行的 E2E 骨架、偵測專案使用的 E2E 框架、找出沒有 E2E 覆蓋的 AC。 Not for: 跨多個故事且帶有共用狀態的旅程——請用 journey-test Skill;撰寫 .feature 場景本身——請用 /bdd。 Keywords: E2E, end-to-end test, feature file, test…

更新
职业分类
未分类
描述

設計一致的錯誤碼,遵循 PREFIX_CATEGORY_NUMBER 格式。 Use when: 定義錯誤碼、建立錯誤處理機制、設計 API。 Not for: 日誌格式與層級——請用 /logging-guide;處理已經到達正式環境的錯誤——請用 /incident。 Keywords: error code, error handling, error format, API errors, 錯誤碼, 錯誤處理, 錯誤格式.

更新
职业分类
未分类
描述

引導 Git 分支策略、分支命名與合併操作。 Use when: 建立分支、合併、pull request、Git 工作流程相關問題。 Not for: 撰寫 commit message——請用 /commit;推送前的安全檢查——請用 /push。 Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程, 分支命名.

更新
职业分类
未分类
描述

引導事故回應、根因分析與事後檢討文件撰寫。 Use when: 正式環境事故、服務中斷回應、撰寫事後檢討、根因分析(RCA)。 Not for: 在故障發生前設計重試與檢查點——請用 /durable;設定告警門檻與 Error Budget 政策——請用 /slo。 Keywords: incident, outage, post-mortem, RCA, root cause, 事故, 服務中斷, 事後檢討, 根因分析.

更新
职业分类
未分类
描述

[UDS] 從專案描述產生連貫的使用者旅程測試計畫(TESTPLAN)與旅程 E2E 骨架。 Use when: 新專案從第一天就需要一條測試旅程、測試跨多個故事延續的狀態、建立以人物誌驅動的旅程計畫。 Not for: 單一 AC 的獨立 E2E 骨架——請用 /e2e;量測實際達成的程式碼覆蓋率——請用 /coverage。 Keywords: user journey, TESTPLAN, journey test, persona, cross-story state, 使用者旅程, 旅程測試,…

更新
职业分类
未分类
描述

[UDS] 透過知識圖追蹤規格、決策與程式碼之間的影響鏈;沒有引擎時以 Markdown 後備方案運作。 Use when: 想知道某份規格或決策會影響到什麼、找出哪些程式碼實作了某個產物、追蹤規格、ADR 與模組之間的相依關係。 Not for: 沒有規格或決策錨點的純文字搜尋——請用 Grep;撰寫規格本身——請用 /sdd。 Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知識圖,…

更新
职业分类
未分类
描述

實作結構化日誌,包含適當的日誌層級與敏感資料處理。 Use when: 加入日誌、除錯、建立可觀測性。 Not for: 指標、追蹤與告警設計——請用 /observability;錯誤碼分類體系——請用 /error-code-guide。 Keywords: logging, log level, structured logging, observability, 日誌, 結構化日誌, 日誌層級, 敏感資料.

更新
职业分类
未分类
描述

[UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 Use when: 評估專案的持續健康狀態、分類技術債並觀察其趨勢、向團隊回報程式碼品質。 Not for: 初次評估一個不熟悉的程式碼庫——請用 /discover;單看測試覆蓋率——請用 /coverage 或 /ac-coverage。 Keywords: metrics, code quality, technical debt, project health, debt trend, 開發指標, 技術債, 專案健康度, 品質趨勢.

更新
职业分类
未分类
描述

[UDS] 引導系統性的程式碼遷移、框架升級與技術現代化。 Use when: 規劃框架或主版本升級、評估遷移風險、在 API 遷移前先擷取合約測試的固定樣本。 Not for: 維持同一套框架的原地改善——請用 /refactor;資料庫 schema 設計——請用 /database。 Keywords: migration, framework upgrade, modernization, breaking change, dependency upgrade, 遷移, 升級, 技術現代化, 破壞性變更.

更新
职业分类
未分类
描述

引導可觀測性建置、指標設計與告警設定。 Use when: 新服務的埋點、SLO 定義、告警設計、成熟度評估。 Not for: 設定數值目標與 Error Budget 政策——請用 /slo;日誌格式與層級——請用 /logging-guide。 Keywords: observability, metrics, traces, golden signals, alerting, SLO, 可觀測性, 指標, 追蹤, 告警.

更新
职业分类
未分类
描述

以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。 Use when: 執行帶有平行/循序任務相依關係的 plan.json 檔案。 Not for: 一開始產生計畫——請用 /plan;彼此之間沒有相依關係的單一任務。 Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行, 任務相依.

更新
职业分类
未分类
描述

從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。 Use when: 把規格轉換成可供 /orchestrate 執行的任務計畫。 Not for: 執行產出的計畫——請用 /orchestrate;判斷這個想法值不值得做——請用 /brainstorm。 Keywords: plan, spec, task plan, plan.json, DAG, 計畫, 規格, 任務, 任務計畫.

更新
职业分类
未分类
描述

引導 pull request 建立、審查自動化與合併策略。 Use when: 建立 PR、自動化審查流程、設定合併政策。 Not for: 審查本身的內容實質——請用 /code-review;分支命名與合併策略——請用 /git-workflow-guide。 Keywords: pull request, PR, merge, review, GitHub, GitLab, 合併請求, 審查自動化, 合併策略.

更新
已展示 40 / 272 个已收集 Skill。