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.py 与 scripts/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 直装。