关于 skill-audit
Skill Audit 是依据代码库证据和可用验证手段审查 Agent 技能包的技能。它区分常规、正式和体验式审计,并指导针对性改进与复验,避免未经说明地消耗额度。
主要功能
- 01常规、正式和体验式审计模式
- 02检查代码库证据
- 03运行免费的结构检查
- 04使用人工评分表
- 05针对性改进并重新验证
- 06明确云端额度使用边界
适用场景
- 01检查技能包是否适合发布
- 02调查触发或工作流问题
- 03审查结构和代码库一致性
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ uinaf/ agent-skills --skill skill-audit安装后在 Claude Code 中输入/skill-audit确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.tessl-plugin/plugin.jsonagents/openai.yamlevals/discovery-audit-and-skill-handoff-routin/criteria.jsontask.mdevals/manual-fallback-when-tessl-unavailable/criteria.jsontask.mdevals/progressive-disclosure-and-file-structur/criteria.jsontask.mdevals/tessl-first-audit-workflow-and-structure/criteria.jsontask.mdreferences/best-practices.mdscorecard.mdtessl.md详细介绍
Skill 审计
根据实际代码仓库和验证范围审计指定的软件包。证据优先于风格偏好。
选择模式
- **常规:**结构、激活、精简或轻量编辑。运行免费的插件 lint,并使用人工评分表;不要消耗云端额度。
- **正式:**明确要求评估发布就绪情况、Tessl 评分,或进行必须达到 100 分的实质性发现/工作流重写。仅当代码仓库提供的启动器、身份验证和额度均可用时,才运行一次范围明确的云端审查。
- **体验式:**最近的任务暴露了激活错误、指导缺失、流程繁琐或工作流脆弱的问题。重现该失败,并做出能够改变行为的最小修改。
阅读 Tessl 政策,了解准确的正式命令、额度限制、回退方案和优化器审批要求。
基线
-
完整阅读代码仓库指南和目标
SKILL.md。 -
仅根据审计范围检查链接的参考资料、脚本、评测、选择器元数据和软件包清单。
-
找出代码仓库提供的验证方式。
-
运行免费的结构基线检查:
pnpm exec tessl plugin lint skills/<name>
如果无法进行正式审查,只需记录一次限制,然后继续执行 lint 和人工评分。绝不要安装工具、进行身份验证、改用其他 CLI、捏造分数,或悄悄消耗额度。
审计维度
- **发现:**名称和描述应指出要执行的操作、不同的触发条件和主要边界,不要堆砌同义词。
- **工作流:**正文应包含清晰的开始步骤、证据循环、停止条件和可观察的完成状态。
- **渐进式披露:**核心决策应留在正文中;每份参考资料都应有明确的任务检索用途;重复的确定性工作应交由现有工具或维护中的可执行资源处理。
- **仓库适配:**链接、命令、元数据和约定均应保持最新,且软件包应能独立使用。
- **验证:**应明确说明可用的最强机械检查,以及现实的证据循环。
- **边界:**软件包既不应承接无关工作,也不应依赖同级技能的身份。
无效元数据、失效链接或命令、缺少完成状态、与仓库冲突,以及依赖同级软件包,均为阻断项。正文臃肿、发现信息含糊、示例抽象、原则重复,以及用文字替代现有确定性实现,均为重大问题。
改进
优先修复阻断项和影响最大的重大问题。选择能够改善激活、决策质量或验证效果的最小改动。精简时,应针对有代表性的请求衡量常见路径的上下文开销;仅看软件包总量和行数无法反映检索成本。
编辑后,重新运行相同的 lint 和仓库门禁。只有在不会泄露结论或造成不安全外部影响时,才使用前向测试来评估技能。
输出
scope: package or portfolio
validation: commands and Tessl score, or explicit no-score boundary
strengths: highest-signal dimensions
findings: blockers and major findings only
changes: files changed or smallest recommended change; include rerun status
评论
支持 Markdown