CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files-zht

用於多步驟 AI 代理工作的持久化檔案規劃。將 task_plan.md、findings.md 與 progress.md 保存在磁碟上,生命週期鉤子會注入選定的專案規劃內容。自動恢復只讀取專案規劃檔案;只有明確執行 session-catchup.py --metadata 才會檢查本機同一專案的代理工作階段中繼資料,--replay 則會輸出有界且以 nonce 框定的摘錄。選用的閘門模式只會在主機支援時要求繼續,而且絕不執行 Markdown 中宣告的命令。此技能沒有網路上傳路徑。適用於研究或需要超過 5 次工具呼叫的工作。觸發詞:任務規劃、專案計畫、制定計畫、分解任務、多步驟規劃、進度追蹤、檔案規劃、幫我規劃、拆解專案

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers a well-sequenced, highly actionable planning workflow with explicit validation gates and error-recovery loops, and it is mostly token-efficient. Its main defect is bundle integrity: the template files and plan-inventory.md it links to as core entry points are missing from the shipped bundle.

Suggestions

Ship the referenced files in the bundle — templates/task_plan.md, templates/findings.md, templates/progress.md, and plan-inventory.md are linked as the primary template and handoff entry points but are absent, leaving the 範本 and 列出已儲存的計畫 sections pointing at nothing.

Show the exact resolve-plan-dir.sh invocation (with PLAN_ID / PWF_PLAN_ROOT argument syntax) and the concrete command used to pin a PLAN_ID to a host, instead of describing both only in prose.

Consolidate the plan-directory selection and pinning guidance repeated across 第一步, 快速開始, and 新計畫的建立約定 into a single section to trim redundant tokens.

DimensionReasoningScore

Conciseness

The body is dense and earns most of its tokens: tables (檔案用途, 讀取 vs 寫入決策矩陣, 反模式), the two-step rule, and the three-failure protocol are all guidance Claude would not produce on its own. Minor over-explanation remains: plan-directory selection and PLAN_ID pinning are restated across "第一步", "快速開始", and "新計畫的建立約定", and the 安全邊界 section repeats defensive statements already in the description — so it sits at 4, not the lean 5.

4 / 5

Actionability

Mostly executable: copy-paste-ready commands such as the session-catchup.py invocations with "$(command -v python3 || command -v python)", "sh \"$PWF_SKILL_DIR/scripts/check-complete.sh\" --validate path/to/task_plan.md", and the set-active-plan --list / --archive <id> / --restore <id> flag set. Minor gaps keep it from 5: the resolve-plan-dir.sh call is described in prose ("配合主機的 PLAN_ID 與 PWF_PLAN_ROOT") without an exact invocation, and how to "釘選" (pin) a PLAN_ID to a host is never shown as a command.

4 / 5

Workflow Clarity

Clear sequence with explicit validation checkpoints and feedback loops: plan resolution steps 1–3 in "第一步", the creation convention requiring the format check to pass "實作前及修改階段結構後" (before implementation and after structural changes), the 三次失敗協定 as an error-recovery loop ending in asking the user, the 五問重啟測試 checklist, and archive operations gated on user consent with a preview step.

5 / 5

Progressive Disclosure

The body is well-sectioned and references are one level deep, but scored against the actual bundle, four of the five non-script references are broken: "[templates/task_plan.md](templates/task_plan.md)", "[templates/findings.md](templates/findings.md)", "[templates/progress.md](templates/progress.md)" and "[plan-inventory.md](plan-inventory.md)" point to files that are absent from the bundle (only SKILL.md and scripts/ ship). The script references (init-session.sh, check-complete.sh, session-catchup.py, resolve-plan-dir.sh, set-active-plan.sh) do resolve. Broken primary entry points push this to 3 rather than 4.

3 / 5

Total

16

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly states what the skill does, when to use it, and a comprehensive set of natural-language trigger terms. Its main weakness is length: several sentences are spent on security/behavioral disclaimers rather than capabilities, which pads the text without improving coverage.

DimensionReasoningScore

Specificity

Names the concrete artifacts and actions: "將 task_plan.md、findings.md 與 progress.md 保存在磁碟上", "生命週期鉤子會注入選定的專案規劃內容", and the specific session-catchup.py --metadata / --replay modes. Falls short of 5 because a sizable share of the text is defensive meta-commentary ("此技能沒有網路上傳路徑", "絕不執行 Markdown 中宣告的命令") that adds constraint statements rather than capability coverage, and core workflow actions are only implied.

4 / 5

Completeness

Clearly answers both questions: what — "持久化檔案規劃。將 task_plan.md、findings.md 與 progress.md 保存在磁碟上" with the hook-injection mechanism; when — "適用於研究或需要超過 5 次工具呼叫的工作" plus explicit concrete trigger phrases. Matches the anchor-5 pattern of 'capabilities + Use when + triggers' exactly.

5 / 5

Trigger Term Quality

Explicit trigger list "觸發詞:任務規劃、專案計畫、制定計畫、分解任務、多步驟規劃、進度追蹤、檔案規劃、幫我規劃、拆解專案" covers nine natural phrases a user would actually say, including synonyms and a casual register ("幫我規劃"), matching the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

The persistent-file-planning niche with named files (task_plan.md/findings.md/progress.md) and distinct trigger terms ("檔案規劃", "多步驟規劃") is mostly distinguishable from other skills. Minor overlap remains with generic planning or project-management skills triggered by broad phrases like "制定計畫" or "幫我規劃", keeping it below the clear-niche anchor.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

OthmanAdi/planning-with-files

Path

skills/i18n/planning-with-files-zht/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.