CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files-zh

用于多步骤 AI 代理工作的持久化文件规划系统。将 task_plan.md、findings.md 和 progress.md 保存在磁盘上,生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据;--replay 可输出有长度限制且由 nonce 框定的同项目摘录。可选门禁仅在宿主支持时请求继续,绝不执行 Markdown 中声明的命令。本技能没有网络上传路径。适用于研究或需要 5 次以上工具调用的工作。触发词:任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目

Quality

82%

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

67%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-organized, largely actionable planning discipline with explicit validation gates, error-recovery loops, and useful decision tables. Its weakest point is bundle navigation: the primary template and plan-inventory references point to files missing from the bundle, and roughly a third of the shipped scripts are undocumented.

Suggestions

Ship the referenced templates (templates/task_plan.md, templates/findings.md, templates/progress.md) and plan-inventory.md in the bundle, or remove/replace the broken links — the core workflow step '只创建缺失的规划文件。在该目录中使用模板' currently points at nonexistent files.

Add a concrete, copy-paste invocation for scripts/resolve-plan-dir.sh (and the PWF_SKILL_DIR / PLAN_ID exports) since it is Step 1 of the restore workflow but currently has no example command line.

Add brief one-line entries to the 脚本 section for the undocumented bundled scripts (attest-plan, phase-status, plan-doctor, ledger-append, ledger-summary, gate-stop, inject-plan) so agents can discover them.

DimensionReasoningScore

Conciseness

The body is dominated by tight tables and terse rules (文件用途表、读取 vs 写入决策矩阵、反模式表) that respect Claude's competence, matching the 'efficient; minor instances of over-explanation' anchor. It is not 5 because the create-plan-first rule is repeated across 快速开始, 新计划的创建约定, and 关键规则 #1, and the 列出已保存的计划 section is somewhat padded.

4 / 5

Actionability

Mostly executable guidance: copy-paste-ready invocations for session-catchup.py (both bash and PowerShell variants with argument patterns), `sh "$PWF_SKILL_DIR/scripts/check-complete.sh" --validate path/to/task_plan.md`, and set-active-plan --list/--archive/--restore. Not 5 because the first and most important step, `resolve-plan-dir.sh`, is described only abstractly ("结合该主机的 PLAN_ID 和 PWF_PLAN_ROOT") with no concrete command line, and PWF_SKILL_DIR export is described but never given as a command.

4 / 5

Workflow Clarity

Explicit validation checkpoints exist ("实现前和修改阶段结构后必须通过检查" via check-complete.sh --validate), a feedback loop for error recovery (三次失败协议), and a checklist (五问重启测试); archive operations require preview plus user consent. Not 5 because the overall sequence is distributed across 第一步, 快速开始, and 新计划的创建约定 rather than one coherent ordered workflow, forcing the reader to synthesize the order.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the `scripts/` references resolve, but the three template links ([templates/task_plan.md](templates/task_plan.md), findings.md, progress.md) and [plan-inventory.md](plan-inventory.md) point to files that do not exist in the bundle, breaking navigation for the skill's core getting-started path ("复制这些模板开始使用"). Additionally, many shipped scripts (attest-plan, phase-status, plan-doctor, ledger-append/summary, inject-plan, gate-stop) are never referenced, so bundle content is undiscoverable. This matches the minimal-structure/broken-navigation anchor more than the 'references present but not clearly signaled' anchor at 3.

2 / 5

Total

14

/

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: it explicitly states what the skill does with concrete file and script names, when to use it, and a rich list of natural trigger phrases with synonyms. Its main weakness is that a large share of the text is spent on privacy/boundary assurances rather than enumerating capabilities, leaving minor coverage gaps.

DimensionReasoningScore

Specificity

Names concrete artifacts ("将 task_plan.md、findings.md 和 progress.md 保存在磁盘上"), hook behavior ("生命周期钩子会注入选定的项目规划上下文"), and specific script modes ("session-catchup.py --metadata"、"--replay 可输出有长度限制且由 nonce 框定的同项目摘录"). It falls short of 5 because capability coverage is tilted toward boundary disclaimers while several bundled capabilities (init-session, check-complete validation, plan inventory/archiving) go unmentioned.

4 / 5

Completeness

Both questions are explicitly answered: what ("用于多步骤 AI 代理工作的持久化文件规划系统" with the three named planning files and hook injection) and when ("适用于研究或需要 5 次以上工具调用的工作" plus the explicit 触发词 list). This matches the anchor for clearly and explicitly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

The explicit trigger list "任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目" provides comprehensive coverage of natural user phrasing with multiple synonyms (制定计划/帮我规划, 分解任务/拆解项目). This clearly matches the anchor for comprehensive natural-term coverage rather than the 'a few natural terms missing' anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The persistent-file-planning niche with named files and hooks is mostly distinct, but broad trigger phrases like "制定计划" and "帮我规划" carry minor overlap risk with other planning or task-management skills. Not 5 because those generic planning phrases could fire for related skills; not 3 because the described mechanism (persistent planning files + lifecycle hooks) is clearly distinguishable.

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-zh/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.