CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

unified-taskflow

【强制】复杂任务管理系统。 AI 必须在遇到以下情况时**先读取此 SKILL.md**,再执行任何操作: - 多文件变更、规划设计、新功能开发 - 用户说"帮我想想/重构/升级/实现" 禁止使用内置 agentic_mode 的 artifact 目录处理复杂任务,必须使用项目根目录下的 .taskflow/ 目录。

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agent/skills/unified-taskflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A well-structured process skill: the phase workflow is clearly sequenced with quantified checkpoints and real error-recovery loops, and detail is appropriately pushed to one-level-deep reference files. The main weaknesses are orphaned bundle scripts, an unexplained .taskflow/ bootstrap (index.json), and some trigger-rule duplication.

Suggestions

Reference scripts/task-lifecycle.py and scripts/session-catchup.py in the body (e.g., in 工作目录 or 完成 sections) with their usage lines — this fixes both the progressive-disclosure orphan gap and the actionability gap for task creation/archiving.

Add a brief bootstrap step explaining how .taskflow/index.json is initialized and maintained, so the workflow is executable from a cold start.

Remove the duplicated trigger rules (keep them in either the CAUTION block or 触发判断 section, not both) and move the '更新:2026-02-13' / v3.0 version markers out of the body's main flow.

DimensionReasoningScore

Conciseness

The body is lean — no explanations of concepts Claude already knows, tight bullets, and detail correctly pushed to reference files. It falls short of 5 due to duplication (trigger rules appear in both the CAUTION block and the 触发判断 section, repeating the frontmatter) and a time-sensitive line ('> 更新:2026-02-13' plus 'v3.0' in the title) that is not in a deprecation/old-patterns section.

4 / 5

Actionability

Guidance is largely executable for an instruction skill: concrete Phase 0 snapshot fields, a tiered execution path per task complexity, quantified rules (2-Action, 3-Strike), and a full directory layout with required/optional files. It misses 5 because two operational gaps remain: nothing explains how to bootstrap .taskflow/ or maintain index.json, and the bundle's task-lifecycle.py / session-catchup.py scripts — which would be the natural executable commands for task creation and archiving — are never referenced.

4 / 5

Workflow Clarity

The Phase 0 → Execution → Completion sequence is clear, with explicit checkpoints (2-Action Rule checkpoint updates, 3-Strike escalation with an excluded-options list, final re-grounding against anchor.md completion criteria) and genuine feedback loops (drift → pause → ask user). It stays below 5 because the archive step ('移入 archive/') and the .taskflow/ initialization are underspecified — no command or procedure is given for either.

4 / 5

Progressive Disclosure

Good structure: SKILL.md is a genuine overview with a dedicated 按需加载 (load-on-demand) section plus a reference table, all 7 linked bundle files (4 references, 3 templates) exist and are one level deep. Scored against the actual bundle per the guidelines, it misses 5 because the two scripts in scripts/ (task-lifecycle.py, session-catchup.py) are orphaned — never mentioned anywhere in SKILL.md, so they are undiscoverable from the index.

4 / 5

Total

16

/

20

Passed

Description

66%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.

The description has strong, explicit trigger guidance with natural user phrases, but the 'what' is thin — it identifies the domain and the .taskflow/ directory mandate without describing any of the skill's actual capabilities. Trigger breadth also creates moderate mis-fire risk on routine multi-file work.

Suggestions

Replace the generic '复杂任务管理系统' what-statement with 2-3 concrete capabilities, e.g., 'Manages complex tasks through understanding snapshots (anchor.md), checkpoint tracking, and periodic re-grounding against the anchor' — this would lift specificity and completeness toward 5.

Narrow or qualify the broadest triggers ('多文件变更', '新功能开发', '帮我想想') so the skill does not compete with ordinary planning/refactoring requests — e.g., require multi-phase or ambiguous-scope tasks.

Add common synonyms/variations to the trigger phrases (e.g., '设计方案', '技术方案', '新功能', English equivalents) to improve trigger-term coverage from good to comprehensive.

DimensionReasoningScore

Specificity

The description names the domain ("复杂任务管理系统" — complex task management system) and one concrete mechanism ("必须使用项目根目录下的 .taskflow/ 目录"), but never states what the skill actually does (anchor/checkpoint phases, re-grounding, etc.). It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive' rather than 4, since the functional actions are entirely absent; it is above 2 because the .taskflow/ directory mandate and read-first rule are concrete.

3 / 5

Completeness

Both 'what' and 'when' are explicitly present: 'what' is "复杂任务管理系统" with the .taskflow/ directory mechanism, and 'when' is a two-item trigger list with concrete user phrases — the explicit trigger guidance means the completeness cap of 3 does not apply. It does not reach 5 because the 'what' is generic ('task management system') and omits the skill's core capabilities, leaving it weaker than the anchor-5 example's concrete what+when pairing.

4 / 5

Trigger Term Quality

Natural user phrases are present: "用户说'帮我想想/重构/升级/实现'" plus technical conditions like "多文件变更、规划设计、新功能开发" — good coverage of terms a user would actually say. It falls short of 5 because there is no synonym expansion (e.g., "设计方案", "新功能", English equivalents) and the technical conditions are tersely phrased.

4 / 5

Distinctiveness Conflict Risk

The domain (.taskflow task-management protocol) is specific and clearly distinct from domain skills, but the triggers "多文件变更" (multi-file changes), "规划设计" (planning/design), "新功能开发" (new feature development), and "帮我想想" (help me think) fire on a large share of ordinary coding sessions, creating real overlap risk with planning/refactoring workflows. It is above 2 because the description carves out a clear niche and explicitly disambiguates against the built-in artifact directory.

3 / 5

Total

14

/

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

relative_links

Relative link issues: 3 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 3 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

ooooooooooooooooooop/ai_life_os

Path

.agent/skills/unified-taskflow/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.