Back to home@gtbwpkwjnb-alt

skills-summarize-audit-skill

Skills Audit — 技能审查·画像·评分·优化 / Universal agent tool auditor — profile, score, optimize

Stars
1
Language
Python
Created
Jun 18, 2026
Updated
Aug 22, 2026
GitHub repo

Introduction

Skills-Summarize-Audit v9.1.0

已安装技能与插件问题审查、版本/可用性核验、用户画像定位与评分、冲突/互补分析、技能翻译精炼、项目画像与工具推荐。默认只读,不负责安装、更新、发布、配置、迁移或历史清理。

核心能力

能力输入输出
已安装技能/插件问题审查当前真实安装登记、技能和插件来源问题严重度、证据、版本、可用性和处理方案
用户画像定位与评分用户画像、结构化使用证据和技能元数据画像命中词、健康维度、评分和证据状态
冲突与互补分析可解释触发词、能力和画像关系冲突/互补/无关关系、重叠度和理由
技能说明翻译精炼侧栏与命令栏完整可见 ID 集合保留英文名称的中文 short_description 候选、质量和来源门禁
项目画像当前或指定项目目录技术栈、项目类型、扫描覆盖和技能推荐
技能/插件推荐翻译清单、项目画像或明确缺口保留/升级/替换/引入/共存/归档建议及证据

触发

  • 技能审查:审查已安装技能/插件问题、版本、画像匹配、评分、冲突/互补,并按请求组合翻译、画像和推荐。
  • 技能问题审查 / 插件问题审查:运行本地只读问题检测,输出证据、严重度和处理方案。
  • 技能翻译精炼技能审查 精炼:只生成翻译候选。
  • 项目画像:只生成当前项目的事实画像。
  • 技能推荐插件推荐:只输出建议。

触发词应独立发送。详细规则见 SKILL.md

边界

  • 不写入 Codex UI、插件缓存、系统技能、配置或项目文件。
  • 不负责安装、更新、卸载、发布、CI/CD、回滚、桌面迁移、环境修复或历史清理;只输出可执行处理建议。
  • 报告发现这类后续工作时,只建议用户直接调用对应 Agent,并说明所需输入与确认边界。
  • 外部搜索需要用户明确同意;无证据时输出 unavailable

验证

python tests/validate.py --strict
python tests/test_collect_codex_display_candidates.py

环境依赖

  • scripts/analyze_project_profile.py 需要 PyYAML:pip install -r requirements.txt。缺失时脚本不再直接崩溃,而是以退出码 2 输出 unavailable 降级信息,相关测试与 validate 的项目画像门禁自动跳过。
  • scripts/collect_codex_display_candidates.pyscripts/audit_skill_plugin_issues.py 仅需标准库 + tomllib(要求 Python ≥ 3.11);PyYAML 对 collect 脚本为可选依赖,缺失时自动降级。

脚本参数

三个脚本均为只读;完整参数以各脚本 argparse 定义为准(-h 查看)。

scripts/analyze_project_profile.py(项目画像,需 PyYAML)

参数说明
project(位置参数)待扫描项目目录
--max-files(默认 2000)扫描文件数上限
--max-depth(默认 10)目录遍历深度上限
--json输出 JSON 画像

scripts/collect_codex_display_candidates.py(Codex 展示候选采集)

参数说明
--root / --catalog-dir / --runtime-dir / --user-skill-dir各来源目录覆盖(root 默认 $CODEX_HOME~/.codex
--scope(visible/installed/catalog/all)采集范围,默认 visible
--visible-id(可重复)当前 UI 可见技能 ID
--expect-visible-count / --provided-visible-count可见数量门禁
--batch-size / --offset分批精炼输出(零基偏移)
--require-chinese / --require-ready / --fail-on-source-conflict / --check-unchanged质量与一致性门禁
--json输出 JSON

scripts/audit_skill_plugin_issues.py(技能/插件问题审查)

参数说明
--root / --catalog-dir / --runtime-dir / --staging-dir / --user-skill-dir各来源目录覆盖
--profile用户画像文件;缺失时 profile_alignment=unavailable
--scope(installed/visible/all)审查范围,默认 installed
--visible-id(可重复)用户提供的可见技能 ID
--fail-on(none/info/warning/critical)严重度门禁
--detail / --json逐项明细 / JSON 输出

DeepSeek Harness 插件市场

本仓库同时是 DeepSeek Harness(dsh)技能包插件,可通过 dsh 插件系统安装:

dsh plugin --profile web add github:gtbwpkwjnb-alt/skills-summarize-audit-skill

安装后重启 dsh web,技能出现在 Settings → Plugins,按需懒加载(渐进式披露)。技能包由本仓库根目录的 SKILL.md 提供,cordis.patch.yml + index.js 为插件外壳(只读 skill provider,无工具、无凭据、无网络请求)。

  • 测试兼容版本:dsh v0.1.1-rc.2(2026-08-22)。预览期版本迭代快,若 API 变更请以官方文档为准。
  • 技能格式:kebab-case 名称 + name/description frontmatter,与 dsh 技能契约一致。
  • 插件外壳无 npm 依赖,可从 GitHub 直装。