driving-work-to-done SKILL.md skillA

driving-work-to-done from hsuanyulee/polaris is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hsuanyulee/polaris/driving-work-to-done@v1.0.0

Pins 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/driving-work-to-done/SKILL.md
Versions recorded
10
Latest version
v1.0.0, committed Oct 20, 2026
First version recorded
Aug 31, 2026
Size
35,992 bytes
Repository stars
5
License
MIT

把一件工作從「有人說了一句話」帶到「judged 過的交付」:先判斷要不要立案,再決定現在 該在 refinement / engineering / verify-ac 哪一站、什麼時候換站,載入說明「這類工作怎麼算 done」的知識,然後一路推進到收斂或撞上四種已宣告的停點之一。任何會改變程式碼或行為的 請求都從這裡進,使用者不需要知道這個名字。唯讀的查詢與說明不走這裡。 有人帶著一件要做的事出現時的第一站,不論他有沒有說出任何指令名稱。例如 「幫我做 X」「這個壞了要修」「想重構 Y」「繼續」「接著推」。 也用於:不知道現在在哪、不知道下一步是什麼、手上有多張單不知道先做哪一張。 不用於:唯讀的查詢與說明(「這支腳本在幹嘛」「查一下 X」)——那些沒有「怎麼算成功」 要簽,直接回答。.

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

# driving-work-to-done — 一件工作、一個入口、一個下一步

三支 skill 各做一站的事:`refinement` 簽下成功的定義,`engineering` 施工,`verify-ac`
判定。**它們都不決定下一步是什麼**——那寫在這裡,只寫在這裡。

一份工作有兩種成功條件,它們住在不同地方:

- **這張單獨有的**(acceptance criteria)→ 進 `refinement` 凍結的 fence。
- **這一類工作共用的**(definition of done)→ 由領域知識帶進來,見〈載入領域知識〉。

把共用的那份寫進每一張單的 fence,等於每次都重簽同樣幾行不承載新資訊的東西。

## 一、有工作進來:要不要立案

判準只有一條:**有沒有「怎麼算成功」需要人簽字。**

| 這件事 | 立案? |
|---|---|
| 查一下、說明一段程式、跑個既有測試 | 否。什麼都沒改,沒有要簽的東西 |
| 會改到程式碼或行為——不論多小 | **是** |
| 不確定 | **是**。立案的成本遠低於做完才發現目標不對 |

**只讀的問題不走這條**,其餘都走。以前這裡有一格是「改 typo、調一個顯然的常數 → 否,
成功的定義不會有爭議」,拆掉了:那一格的判準是「這件事夠小」,而那是每次都由當事人自己
判、每次都會判得更寬的東西。

**把判斷與依據說出來**,一句話就夠,讓人能當場推翻。不立案的到此為止,直接把事做完。

### 這件事可能已經有主人

開一張新單之前,先問這件事是不是已經有一張單在管。三種情況最常被開成新單:

- **跟一張母單意圖相關的問題是研究。** 結果寫成那張母單的一則留言,不開子單,也不開 PR。
  施工只做那張母單底下已經簽過的子單。
- **量到新東西時,先問現在哪一張單在管這件事。** 有就寫進那一張,不另開。一張單的母單要是
  它真正的主人:能對回別人母單描述的工作,寫成留言給那張母單,不掛在自己的母單底下。
- **對照出來的缺口不是 bug。**「舊的有、新的沒有」是程式碼的事實,bug 是使用者的事實。
  先在線上用真實操作重現一個使用者看得到的症狀;重現不了,就在盤點紀錄寫一行,不立案。

2026-09-23 的標本:使用者問一張母單做完能不能清掉某份清單。分析結果被開成三張盤點單,盤點
又生出六張,一天九張,最後全部併回原有的子單。2026-09-15 的標本:一次遷移之後盤出兩條對照
缺口,直接開成兩張 bug、合成一顆 PR、部了四台測試機;兩天後證明一條在真實路徑上零差異、
一條在畫面上從不出現,兩張都關掉。

### 手上正在做別的事,但長出了一個不能消失的東西
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hsuanyulee/polaris/driving-work-to-done@sha256:0095368daca77dae

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_5inpggmcihdeofli.svg)](https://markdownregistry.com/a/art_5inpggmcihdeofli)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Aug 31, 2026 and Oct 20, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-10-20 787c021 35,992 BA view · diff
v1.0.02026-10-05 7017eb5 35,160 BA view · diff
v1.0.02026-09-30 ac2f215 34,988 BA view · diff
v1.0.02026-09-29 9afe770 33,705 BA view · diff
v1.0.02026-09-16 47d2de1 33,384 BA view · diff
v1.0.02026-09-06 9d06110 32,712 BA view · diff
v1.0.02026-09-04 0500cde 31,511 BA view · diff
v1.0.02026-09-03 50f6461 30,713 BA view · diff
v1.0.02026-09-03 8e4c351 29,640 BA view · diff
v1.0.02026-08-31 1676e27 27,895 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (35992 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

GitHub

hsuanyulee/polaris · 5 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5inpggmcihdeofli
GET https://markdownregistry.com/api/v1/resolve?ref=hsuanyulee/polaris/driving-work-to-done
GET https://markdownregistry.com/api/v1/blob/0095368daca77daea493ecfe979cf4825f783a7af4171eac605da638c469c2f8

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.

More from hsuanyulee/polaris

check-your-own-work SKILL.md skill
hsuanyulee/polaris · .claude/skills/check-your-own-work/SKILL.md · Before handing your own change over — opening a PR, asking for review, saying "done" — check it against nine questions…
v1.0.0 · audit A · 5 stars
checkpoint SKILL.md skill
hsuanyulee/polaris · .claude/skills/checkpoint/SKILL.md · 保存、恢復、列出長 session checkpoint;記錄 branch、ticket、todo、recent activity,方便中斷或 context compression 後接續。 session…
v1.2.0 · audit A · 5 stars
command-post SKILL.md skill
hsuanyulee/polaris · .claude/skills/command-post/SKILL.md · Commander mode: use when one session commands the other Claude sessions on this machine — to read the map of who holds…
git:20261020.908921c · audit A · 5 stars
engineering SKILL.md skill
hsuanyulee/polaris · .claude/skills/engineering/SKILL.md · 已經有凍結的 assertion、要開始或繼續施工時的站。兩個關卡之間的 loop:探索、實作、換量測、推進輪次。這裡沒有關卡。 某張單的 assertion 已經凍結,接下來要動手做的時候,或剛從 refinement…
v3.0.0 · audit A · 5 stars
framework-self-dev SKILL.md skill
hsuanyulee/polaris · .claude/skills/framework-self-dev/SKILL.md · 在框架自己身上施工時要知道的事:一張框架單怎麼開。兩種單——舉發實作途中撞到的問題、 開發框架新功能——開單那一刻問的格子不一樣,而舉發那一種要先看過還沒出去的單裡有沒有 同一件。 要改的東西是這套流程自己(skill、它們的腳本、常駐規…
v1.0.0 · audit A · 5 stars
learning SKILL.md skill
hsuanyulee/polaris · .claude/skills/learning/SKILL.md · "Use when the user wants to learn from external resources (URLs, repos, articles), extract patterns from merged PRs…
v3.1.0 · audit A · 5 stars
memory-hygiene SKILL.md skill
hsuanyulee/polaris · .claude/skills/memory-hygiene/SKILL.md · Manual memory tiering — classify Hot/Warm/Cold, review candidates, and migrate MEMORY.md index + memory files. Use when…
v1.1.0 · audit A · 5 stars
pr-pickup SKILL.md skill
hsuanyulee/polaris · .claude/skills/pr-pickup/SKILL.md · Slack collaboration layer: extracts PR URLs from Slack messages, hands the PR over to be fixed, then reports back to…
v1.0.0 · audit A · 5 stars
refinement SKILL.md skill
hsuanyulee/polaris · .claude/skills/refinement/SKILL.md · 流程的第一站,也是第一個關卡:把「怎麼算成功」談成人簽得下去的 assertion,凍結起來。由 driving-work-to-done 在判定要立案之後帶進來。 driving-work-to-done…
v3.0.0 · audit A · 5 stars
request-pr-review SKILL.md skill
hsuanyulee/polaris · .claude/skills/request-pr-review/SKILL.md · "把使用者名下已經開好的 PR 蒐集起來、帶回每一個的 review 狀態、列出來讓他決定要請誰看,然後通知對的人。Trigger: '我的 PR', 'request PR review', 'ask someone to review…
v4.0.0 · audit A · 5 stars
review-inbox SKILL.md skill
hsuanyulee/polaris · .claude/skills/review-inbox/SKILL.md · "Use when the user wants to discover and review PRs across the team awaiting their attention. NOT for a single specific…
v3.0.0 · audit A · 5 stars
review-pr SKILL.md skill
hsuanyulee/polaris · .claude/skills/review-pr/SKILL.md · Review someone else's PR as a code reviewer: read the PR diff, check against .claude/rules, leave inline comments on…
v2.1.0 · audit A · 5 stars

Every file in hsuanyulee/polaris

Browse by kind, by grade A, or by owner.