mcpField
S
skill-audit

skill-audit

github.com/uinafAgent 工作流0178 次安装4 天前更新
代码仓库

关于 skill-audit

Skill Audit 是依据代码库证据和可用验证手段审查 Agent 技能包的技能。它区分常规、正式和体验式审计,并指导针对性改进与复验,避免未经说明地消耗额度。

主要功能

  1. 01常规、正式和体验式审计模式
  2. 02检查代码库证据
  3. 03运行免费的结构检查
  4. 04使用人工评分表
  5. 05针对性改进并重新验证
  6. 06明确云端额度使用边界

适用场景

  1. 01检查技能包是否适合发布
  2. 02调查触发或工作流问题
  3. 03审查结构和代码库一致性

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/uinaf/agent-skills --skill skill-audit

安装后在 Claude Code 中输入/skill-audit确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.tessl-plugin/
plugin.json
agents/
openai.yaml
evals/discovery-audit-and-skill-handoff-routin/
criteria.json
task.md
evals/manual-fallback-when-tessl-unavailable/
criteria.json
task.md
evals/progressive-disclosure-and-file-structur/
criteria.json
task.md
evals/tessl-first-audit-workflow-and-structure/
criteria.json
task.md
references/
best-practices.md
scorecard.md
tessl.md

详细介绍

Skill 审计

根据实际代码仓库和验证范围审计指定的软件包。证据优先于风格偏好。

选择模式

  • **常规:**结构、激活、精简或轻量编辑。运行免费的插件 lint,并使用人工评分表;不要消耗云端额度。
  • **正式:**明确要求评估发布就绪情况、Tessl 评分,或进行必须达到 100 分的实质性发现/工作流重写。仅当代码仓库提供的启动器、身份验证和额度均可用时,才运行一次范围明确的云端审查。
  • **体验式:**最近的任务暴露了激活错误、指导缺失、流程繁琐或工作流脆弱的问题。重现该失败,并做出能够改变行为的最小修改。

阅读 Tessl 政策,了解准确的正式命令、额度限制、回退方案和优化器审批要求。

基线

  1. 完整阅读代码仓库指南和目标 SKILL.md。

  2. 仅根据审计范围检查链接的参考资料、脚本、评测、选择器元数据和软件包清单。

  3. 找出代码仓库提供的验证方式。

  4. 运行免费的结构基线检查:

    pnpm exec tessl plugin lint skills/<name>
    
  5. 使用评分表和编写指南。

如果无法进行正式审查,只需记录一次限制,然后继续执行 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