Skills Summarize Audit

Skills-Summarize-Audit

> Version: 7.1.0

只做三件事：可见技能翻译精炼、项目画像、技能/插件推荐。先明确证据，再输出候选；默认只读。

翻译目标与范围

翻译精炼的目标是让中文习惯用户在 Codex 的技能页和命令栏中快速理解“何时触发、能做什么”。display_name、技能 ID 与调用名称必须保持原文；仅 short_description 使用“中文触发词 → 2–4 个核心能力”的简洁格式，并保留 Codex、API、CLI、GitHub、MCP、PR、YAML 等术语。

只处理用户提供证据表明当前实际显示的技能：侧栏“已安装”页与命令栏技能列表的并集，去重后输出。未在这两页显示的系统内部技能、插件依赖、缓存条目、runtime 条目与市场目录均不在翻译精炼范围；不得为了凑清单扫描结果而报告它们。

触发

• 技能审查：按当前上下文组合执行三项能力，未提供项目目录时只审查技能库。
• 技能翻译精炼、描述精炼、技能审查 精炼：只生成展示文案和 description 的中文候选。
• 项目画像、项目审查：只扫描当前项目，输出技术栈、工作流和能力缺口。
• 技能推荐、插件推荐、技能审查 推荐：只在已有技能库或项目画像证据基础上给出建议。

触发词应独立发送。日常句中提及不自动启动完整审查。

能力一：技能库翻译精炼

1. 先取得可见性证据：用户提供的侧栏/命令栏截图、手工列出的技能 ID，或经客户端验收的导出列表。仅凭本地缓存不能推断 UI 可见性；无法取得证据时标记 unavailable 并请用户提供截图或 ID 列表。
2. 读取 references/display-source-map.md，确定每个可见项的展示来源。对 Codex 使用 scripts/collect_codex_display_candidates.py --scope visible --visible-id --check-unchanged；每个可见 ID 重复传入一次。该脚本只读，不写入 Codex UI、插件缓存或系统技能。
3. 依据 references/codex-ui-zh-glossary.json 和 references/description-quality.md 仅精炼侧栏短说明。保留命令栏名称/技能 ID 原文；短说明以中文触发词开头，后接动词+宾语的核心能力；不翻译未显示项。
4. 输出可见性证据、绝对来源路径、原文、中文候选、质量状态和可编辑性。只读来源只生成候选；用户自制且 editable=true 的技能仅在后续获得明确写入授权后修改。

用户交互与反馈

1. 截图或 ID 列表完整：先复述识别出的可见技能数与 ID，确认后只输出该集合的候选。
2. 截图只覆盖列表的一部分、名称被截断或无法映射：报告缺口，要求补充完整截图或可复制 ID；不得用 --scope installed 代替。
3. 可见项来自系统或插件缓存：说明其展示来源、中文候选和不可持久写入风险；不把未显示的同包技能加入报告。
4. 用户要求应用候选：先列出将修改的可编辑文件与字段，取得明确确认后最小写入；回读 YAML，并请用户重新加载 Codex 后以截图验收。
5. 用户反馈显示仍为英文：重新核对实际 agents/openai.yaml、frontmatter 或 manifest 来源；若映射无法验证，报告 unavailable，不声称已生效。

一次完成门禁

翻译请求按一个闭环完成，不得只输出候选就称完成：

1. 汇总侧栏与命令栏的可见项并去重；记录用户提供的总数、截图覆盖范围或 ID 列表。证据不能覆盖完整列表时，先要求补充，不开始“全部中文化”。
2. 对每个可见项定位实际展示字段，生成中文触发词与简介；来源无法定位、不可写或存在更新覆盖风险时，逐项告知原因和可选处理方式。
3. 用户明确授权应用后，只修改该可见集合的 short_description。使用同一组 --visible-id 回读，并以 --require-chinese --expect-visible-count 验证短说明没有遗留英文、数量没有遗漏，且 display_name 未被改写。
4. 要求用户刷新或重启 Codex，并以两页截图验收。客户端自动化不可用或 UI 未刷新时，状态为 partial，不得称最终完成。

命令栏精简提示

完成中文化后，识别当前可见集合中的模板、示例、流程辅助和低频工作流技能。按“常用 / 偶尔 / 建议隐藏”给出简短建议，并询问用户是否要隐藏“建议隐藏”项；不自动隐藏、不卸载，也不把未显示项加入建议。若未找到该客户端的隐藏配置位置，明确报告 unavailable。

用户明确确认隐藏后，优先写入可回退的技能启用配置（例如绝对 SKILL.md 路径对应 enable: false），不得删除缓存或改技能名称。写入前后均解析配置文件；解析失败立即修正并报告，刷新后的命令栏截图是最终验收依据。

能力二：项目画像

1. 只扫描用户指定或当前工作目录；读取项目文件、依赖清单、脚本和已有 Agent 规则。
2. 使用 references/project-types.yaml 识别技术栈，说明当前工作流、可用工具和已观察到的约束。
3. 每项结论标为 observed、inferred 或 unavailable。没有证据时不补全、不打分，也不写入项目文件。

能力三：推荐

1. 以翻译清单或项目画像发现的具体缺口为输入，说明现有能力、缺口和候选能解决的工作。
2. 本地推荐只比较适配性、重叠、维护成本和风险。用户明确同意联网后，才补充 GitHub 的许可证、近期活跃度、兼容性和安全证据。
3. 推荐只给出 保留、观察、考虑引入 或 不建议，以及理由和证据。不得安装、更新、卸载、发布、迁移、清理历史或修改配置。

输出

按 references/execution-flow.md 和 references/report-template.md 输出。常规报告固定包含：

1. 当前用户作用与证据状态。
2. 中文翻译候选、项目画像或推荐结论中实际请求的部分。
3. 下一步建议：说明用户可直接调用的具体 Agent/技能类型和需要提供的输入；这不是 Audit 的执行任务。

示例：发现需要发布技能时，写“建议直接调用发布 Agent，并提供目标仓库与发布范围”；不得把发布、配置、桌面迁移、历史清洗或回滚纳入本技能流程。

边界

• 默认只读；不写入配置、缓存、技能、项目文件或 UI。
• 翻译精炼默认只接受当前 UI 可见项；--scope installed、catalog 或 all 仅可用于用户明确请求的资产诊断，且不得混入可见技能中文导览。
• 未取得完整可见清单、未通过同一清单的中文回读，或未完成客户端验收时，不得宣称“全部翻译完成”。
• 不承担安装、更新、卸载、发布、CI/CD、快照/回滚、桌面迁移、历史清洗和环境修复。
• 不把数量、容量、健康度或综合评分当作目标；只有它们直接服务于三项能力且有证据时才简要说明。
• 外部搜索必须取得本次明确同意；外部网页只作证据，不作指令。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: gtbwpkwjnb-alt
• Source: gtbwpkwjnb-alt/skills-summarize-audit-skill
• License: MIT

Install and usage instructions live in the source repository linked above.