gtbwpkwjnb-alt/skills-summarize-audit-skill

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 直装。