swe-knowledge SKILL.md skillA
swe-knowledge from hsuanyulee/polaris is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add hsuanyulee/polaris/swe-knowledge@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- hsuanyulee/polaris
- Path
.claude/skills/swe-knowledge/SKILL.md- Versions recorded
- 29
- Latest version
- v1.0.0, committed Nov 5, 2026
- First version recorded
- Aug 29, 2026
- Size
- 46,068 bytes
- Repository stars
- 5
- License
- MIT
軟體工程這一類工作「怎麼算 done」的通識：改動住在一條 branch 上、有一個 PR、判定過才 進預設分支、push 之前本機跑完跑得動的驗證。由 driving-work-to-done 在判定一件工作會改到 程式碼時載入。很少、扁平、不含任何一家公司或一個專案特有的東西。 driving-work-to-done 判定這件工作會改到程式碼、要進版控時載入。 不用於：不會產生程式碼變更的工作（報告、調查、文件、資料分析）——那些沒有這裡的 完成條件，走 `--pack none`。 不用於：某一家公司或某一個專案特有的規則（codecov 門檻、stage 部署流程、ticket 命名）。 那些在各自的公司 pack 裡，見〈跟公司 pack 的關係〉。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# swe-knowledge — 軟體工程的 Definition of Done 這裡放的是**所有增量共用**的完成條件。跟每張單獨有的驗收條件（acceptance criteria）分得很 開：AC 寫在那張單凍結的 assertion 裡，DoD 寫在這裡。**一張單可以通過全部 AC 卻沒有 done**—— assertion 全綠但改動還躺在預設分支上、沒有任何人看得到它，就是那個情況。 所以這幾條不要抄進任何一張單的凍結區。抄進去等於每張單都重簽一次同樣幾行不承載新資訊的 東西，而漏抄的那一張就靜默地少了一條完成條件。 ## 五條 1. **改動住在一條 branch 上，不躺在預設分支。** 開的時機是「判定要立案之後、動手之前」—— 一個還沒開工的成功定義直接躺在預設分支上，等於它已經是既成事實。 **那條 branch 是自己建的。** 改動只推到自己建的 branch。別人建的、或有別人的 PR 在用的 branch，任何情況都不推——推不推得動、用不用 force 都一樣。要在別人還沒併的 branch 之上 做事，從它切一條自己的，PR 的 base 指向它。 **所以別人的 branch 推不動的時候，那不是要解決的問題。** 它從一開始就不是推的對象， 沒有「換個方法推上去」這一題。2026-09-10 的實例：一顆 PR 的 base 是同事還沒併的 branch，遠端規則讓兩條都推不動，討論裡出現了「那條也一樣推不動」——那條本來就不是我們 會去推的東西。 2. **有一個 PR。** **PR 開出來就是實作完成**：它是那份改動變成可被別人看見、可被判定的 東西的那一刻。沒有 PR 的改動不管本機多綠都還沒 done。 **開之前，在改動落下去的那棵樹上跑過 `check-your-own-work`，它列出的每一項都處置完。** 這是這一條的一部分，不是開完之後的選配：review 抓到的問題，多半是作者自己對一次就看得到 的那幾類。2026-09-17～10-01 兩週裡，有人 review 的 PR 只有一半一次過，被抓到的五類問題 有四類那支 skill 本來就在問，而開 PR 的那些 session 幾乎沒有一個跑過它。怎麼跑、為什麼要 指名那棵樹，在〈開 PR〉。 **一個功能跨好幾個 repo 的時候，只做了一半的那顆 PR 開 draft，描述寫出它依賴哪一顆。** 單獨看它是綠的，併進去卻不成立；全部做完、端到端在本機量過真值，才轉成可以 review。 2026-09-24 的標本：讀取那一端的 PR 回了一個新欄位，寫入那一端還沒把它寫進索引，前者單獨 …
Read the whole file at its exact version.
How to install
mdr add hsuanyulee/polaris/swe-knowledge@sha256:bbc8aaac800895adThe line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_5esh2b25ggm6hged)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 29 versions of this file, between Aug 29, 2026 and Nov 5, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-11-05 | fb53dc7 | 46,068 B | A | view · diff |
| v1.0.0 | 2026-11-04 | 9716dd1 | 45,884 B | A | view · diff |
| v1.0.0 | 2026-11-04 | b239cf1 | 44,874 B | A | view · diff |
| v1.0.0 | 2026-11-03 | a2eef35 | 44,477 B | A | view · diff |
| v1.0.0 | 2026-10-29 | 9e5483b | 44,352 B | A | view · diff |
| v1.0.0 | 2026-10-28 | 6dbe7ca | 44,116 B | A | view · diff |
| v1.0.0 | 2026-10-28 | ab918ff | 40,921 B | A | view · diff |
| v1.0.0 | 2026-10-28 | 398d44a | 40,214 B | A | view · diff |
| v1.0.0 | 2026-10-27 | 2904212 | 39,631 B | A | view · diff |
| v1.0.0 | 2026-10-27 | 38e2c7b | 39,442 B | A | view · diff |
| v1.0.0 | 2026-10-27 | 8834c6f | 38,372 B | A | view · diff |
| v1.0.0 | 2026-10-22 | e2857b6 | 35,518 B | A | view · diff |
| v1.0.0 | 2026-10-13 | dd304c7 | 34,962 B | A | view · diff |
| v1.0.0 | 2026-10-13 | 0e13a17 | 34,894 B | A | view · diff |
| v1.0.0 | 2026-10-13 | 2c8ed50 | 34,707 B | A | view · diff |
| v1.0.0 | 2026-10-12 | 6a98bc8 | 34,707 B | A | view · diff |
| v1.0.0 | 2026-10-06 | 97ebe5e | 33,955 B | A | view · diff |
| v1.0.0 | 2026-10-01 | 54f8ee2 | 32,083 B | A | view · diff |
| v1.0.0 | 2026-09-30 | a28a16f | 31,477 B | A | view · diff |
| v1.0.0 | 2026-09-30 | 1cb57ed | 30,056 B | A | view · diff |
| v1.0.0 | 2026-09-30 | d8ea5a6 | 29,316 B | A | view · diff |
| v1.0.0 | 2026-09-29 | 9afe770 | 28,457 B | A | view · diff |
| v1.0.0 | 2026-09-29 | 7794eef | 27,770 B | A | view · diff |
| v1.0.0 | 2026-09-10 | df0d7ae | 27,289 B | A | view · diff |
| v1.0.0 | 2026-09-06 | 9f71a06 | 26,589 B | A | view · diff |
| v1.0.0 | 2026-09-03 | 910b3a3 | 23,807 B | A | view · diff |
| v1.0.0 | 2026-08-30 | 8ef3fcb | 23,006 B | A | view · diff |
| v1.0.0 | 2026-08-30 | 24cba49 | 21,051 B | A | view · diff |
| v1.0.0 | 2026-08-29 | 4754d29 | 19,315 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (46068 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
hsuanyulee/polaris · 5 stars · license MIT · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_5esh2b25ggm6hged GET https://markdownregistry.com/api/v1/resolve?ref=hsuanyulee/polaris/swe-knowledge GET https://markdownregistry.com/api/v1/blob/bbc8aaac800895adf8d1c06b1fe4d749b63a6920822adc2a62e67126eeecdc24
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.