用途
tessl-skill-review 用于对 Agent Skill 或 SKILL.md 进行质量评估、评分与审查，核心目标是用 Tessl 作为默认评分引擎来衡量技能质量，而不仅仅是给出主观感受。它强调优先采用 Tessl 支持的评审，再在此基础上补充人工判断。
主要使用场景包括：给技能打分、评估 SKILL.md、按最佳实践审查技能、比较两个技能版本、判断技能是否已准备好发布，以及发现技能在触发、结构或指令方面的弱点。
主要能力
- 以 Tessl 作为默认评分引擎进行技能质量评审。
- 从 Tessl 评审输出中提取结构化评分卡，至少包括：总体分数、最强项、最弱项、触发/描述质量问题、指令清晰度问题、缺失示例或薄弱的工作流指导、上下文膨胀或冗余风险、发布就绪判断。若 Tessl 返回分类分数，尽量原样保留。
- 在 Tessl 无法安装或执行时，提供手动回退评分量表。
- 支持基于场景的评估，用于更深入的验证。
使用方式
核心工作流
-
确定评审目标：接受包含 SKILL.md 的技能目录、SKILL.md 的直接路径，或包含一个或多个待审计技能的仓库路径。若请求不明确，需澄清要评分哪个技能或目录。
-
优先使用 Tessl 评审：若 Tessl CLI 可用，从以下命令开始：
tessl skill review <path>
示例：
tessl skill review ~/.openclaw/skills/meta-cognition
tessl skill review ./skills/work-to-skill
tessl skill review ./skills/some-skill/SKILL.md
若 CLI 具体接口有变化，可检查：
tessl --help
tessl skill --help
若 Tessl 未安装，可安装：
curl -fsSL https://get.tessl.io | sh
或使用捆绑的辅助脚本：
scripts/review.sh <path>
该辅助脚本会检测 Tessl 是否存在，若缺失则打印安装命令，并在可用时运行 tessl skill review <path>。
- 提取结构化评分卡：从 Tessl 评审输出中捕获总体分数、最强项、最弱项、触发/描述质量问题、指令清晰度问题、缺失示例/薄弱工作流指导、上下文膨胀或冗余风险、发布就绪判断。
手动回退评分量表
若 Tessl 无法安装或执行，使用以下评分量表进行手动评审。每个维度按 1-5 分评分：
- 触发清晰度：描述是否清楚说明技能做什么以及何时使用？
- 工作流可执行性：另一个 agent 能否无需猜测地遵循步骤？
- 上下文效率：技能是否精简，还是浪费上下文？
- 可复用性：是否避免隐藏的团队知识和仅限本地的假设？
- 安全性：是否正确约束有风险或不可逆的操作？
转换为 100 分制：
Total = (sum of 5 dimension scores / 25) * 100
判定区间：
- 90-100：可发布
- 75-89：较强，但需改进少数方面
- 60-74：有用，但需大幅修订
- <60：未就绪
始终明确说明分数来自 Tessl 还是手动回退量表。
次要工作流：基于场景的评估
当用户需要更深入的验证时，可超越技能评审，运行场景评估。当问题不只是“写得是否好”，而是“该技能是否真正提升 agent 表现”时，使用 Tessl 场景工具。
首选流程：
tessl scenario generate <path>
tessl scenario run <path-or-scenario>
场景评估适用于：编辑技能后的回归检查、比较两个技能版本、检查额外上下文是否真正有帮助、判断真实任务成功而非仅表面质量。
分析维度
在 Tessl 输出之后，从以下维度补充自己的判断：
-
触发质量：frontmatter 描述是否足够具体以可靠触发？是否同时说明技能做什么和何时使用？是否过于模糊、过于通用或过于狭窄？
-
工作流质量：步骤是否可执行？技能是否引导 agent 做决策，而不仅是倾倒信息？脆弱步骤是否得到充分约束？
-
上下文效率：正文是否足够简洁？是否重复了模型已知的明显知识？详细材料是否应移入引用而非膨胀 SKILL.md？
-
可复用性：另一个 agent 实例能否在无需额外团队知识的情况下使用？假设、前置条件和输入是否明确？
-
安全性与越界：技能是否在缺乏适当检查的情况下推动 agent 进行有风险或不可逆的操作？审批边界和破坏性操作是否处理清楚？
输出格式
除非用户要求其他格式，使用以下输出结构：
## Tessl Skill Review
- Target:
- Tessl overall score:
- Verdict: ready / close / needs work / not publishable yet
## Strengths
- ...
## Weaknesses
- ...
## High-impact fixes
1. ...
2. ...
3. ...
## Suggested rewrite areas
- frontmatter:
- workflow:
- examples:
- references/scripts:
## Final recommendation
- ...
发布 / PR 用途
在为 PR 或公共注册表提交审查技能时：将 Tessl 分数作为输入而非唯一决策依据；指出分数与真实世界有用性之间的任何不匹配；标记私有环境耦合、硬编码路径、密钥处理或薄弱的公共可读性。
反模式
不要：
- 在 Tessl 可用时未实际运行 Tessl 就给出分数
- 将“写得漂亮”与“有效的 agent 行为”混为一谈
- 接受没有可执行工作流的高层技能
- 仅因文字听起来精致就忽略膨胀的上下文
- 仅因技能很长就认为它好
快速命令清单
# install if needed
curl -fsSL https://get.tessl.io | sh
# or use the bundled helper
scripts/review.sh <path>
# inspect CLI if unsure
tessl --help
tessl skill --help
# basic quality review
tessl skill review <path>
# deeper evals when needed
tessl scenario generate <path>
tessl scenario run <path-or-scenario>
触发短语
- “测一下这个 skill 的评分”
- “帮我评估这个 SKILL.md”
- “这个 skill 质量怎么样”
- “用 Tessl 跑一下 skill review”
- “compare these two skill versions”
- “is this skill publish-ready?”
- “score this skill”
- “review this skill against best practices”
限制
资料未提供该技能的具体平台支持范围、收费或价格信息、性能效果数据，也未提供除上述命令与脚本之外的其他安装或使用细节。