{"slug":"compact-bensz-skills","title":"compact-bensz-skills","summary":"当用户明确要求“压缩/瘦身/精简某个 Agent Skill 的 Markdown 文档”“在不改变功能前提下降低 skill 上下文开销”时使用。先理解目标 skill 的真实能力与安全边界，再在忽略 `tests/`、`plans/` 以及目标 skill 的 `README.md`、`CHANGELOG.md` 的前提下，压缩 `SKILL.md`、`references/*.md` 等工作型 Markdown，并把中间产物隔离到 `.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/compact-bensz-skill","platform":"Claude","tags":["agent-skills"],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-27T17:01:24.870415Z","repo":{"url":"https://github.com/huangwb8/skills","stars":48,"forks":8,"license":"MIT","updatedAt":"2026-09-25T04:25:50Z"},"bodyHtml":"

compact-bensz-skills

\n

compact-bensz-skills 用来压缩某个 Agent Skill 里的工作型 Markdown 文档，目标是在不改变原有功能的前提下，显著降低上下文体积。

\n

最推荐用法

\n
请使用 compact-bensz-skills skill 压缩这个 Agent Skill 的工作型 Markdown 文档。\n输入：/path/to/target-skill\n输出：更新后的 skill 源文件；所有中间文件保存在目标目录下的 .bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/compact-bensz-skills/\n
\n

适用场景

\n\n

默认行为

\n\n

常用示例

\n

示例 1：压缩单个 skill

\n
请使用 compact-bensz-skills skill 压缩 `git-pr-review` 这个 skill 的工作型 Markdown 文档。\n输入：/workspace/skills/git-pr-review\n输出：原 skill 目录内更新后的 Markdown；中间文件放到 `.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/compact-bensz-skills/`\n
\n

示例 2：指定额外约束

\n
请使用 compact-bensz-skills skill 压缩这个 skill 的工作型 Markdown。\n输入：/workspace/skills/my-skill\n输出：更新后的 skill 源文件\n另外，还有下列参数约束：\n- 只压缩 Markdown，不改 Python/Bash 脚本\n- 默认不要动 README.md / CHANGELOG.md\n- 不要改变 SKILL.md frontmatter 的 name\n- 压缩完成后要输出压缩前后统计\n
\n

运行时会生成什么

\n\n

备选用法（脚本）

\n
python3 compact-bensz-skills/scripts/init_workspace.py --skill-root /path/to/target-skill\npython3 compact-bensz-skills/scripts/measure_markdown.py --skill-root /path/to/target-skill --phase after\npython3 compact-bensz-skills/scripts/validate_compaction.py --skill-root /path/to/target-skill\n
\n

如果你想显式锁定某一轮：

\n
python3 compact-bensz-skills/scripts/init_workspace.py --skill-root /path/to/target-skill\n# 记下输出里的 run_id\npython3 compact-bensz-skills/scripts/measure_markdown.py --skill-root /path/to/target-skill --run-id 2026-03-28-15-52 --phase after\npython3 compact-bensz-skills/scripts/validate_compaction.py --skill-root /path/to/target-skill --run-id 2026-03-28-15-52\n
\n

WHICHMODEL

\n

最后核对：2026-03-28。

\n\n

参考：

\n\n

FAQ

\n

它会改 tests/ 和 plans/ 吗？

\n

不会。这个 skill 默认忽略目标 skill 里的 tests/ 和 plans/。

\n

它会处理 README.md 或 CHANGELOG.md 吗？

\n

默认不会。这个 skill 只把工作型 Markdown 视为主要目标；目标 skill 根目录下的 README.md、CHANGELOG.md 一般属于面向人类的说明或发布记录，不纳入默认压缩范围。

\n

它会自动改脚本代码吗？

\n

默认不会。它的核心目标是压缩 Markdown 文档；只有当文档与脚本明显不一致时，才应先指出风险，再做最小修正。

\n

它怎么保证不破坏功能？

\n

它要求先理解 SKILL.md、config.yaml、scripts/，然后再压缩文档，并在最后运行统计和校验脚本。

\n

为什么现在要用 `

\n

因为这个 skill 可能会反复执行。按分钟级 run 目录隔离后，每一轮的快照、统计和验证结果都能独立追溯，不会被下一轮覆盖；同一分钟重复运行时脚本会自动追加后缀。

\n

它会检查相对链接是否越界吗？

\n

会。validate_compaction.py 现在不仅检查链接是否存在，也会拒绝链接跳出目标 skill 根目录。

\n","files":[{"path":"CHANGELOG.md","sizeBytes":2573,"isText":true},{"path":"config.yaml","sizeBytes":1683,"isText":true},{"path":"README.md","sizeBytes":6455,"isText":true},{"path":"references/compaction-playbook.md","sizeBytes":1712,"isText":true},{"path":"references/preservation-checklist.md","sizeBytes":891,"isText":true},{"path":"references/validation-checklist.md","sizeBytes":902,"isText":true},{"path":"scripts/common.py","sizeBytes":10164,"isText":true},{"path":"scripts/init_workspace.py","sizeBytes":3846,"isText":true},{"path":"scripts/measure_markdown.py","sizeBytes":3020,"isText":true},{"path":"scripts/validate_compaction.py","sizeBytes":4788,"isText":true},{"path":"SKILL.md","sizeBytes":10156,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-08T11:57:29.155285Z","sha256":"F1D5EF7620F997AB06D579ADFE01CFD4013C30C328AE2D90D6D52C4A04FC0DB5","sizeBytes":20832},"review":null,"source":{"repositoryUrl":"https://github.com/huangwb8/skills","path":"skills/alpha/compact-bensz-skills","license":"MIT","commit":"9cba9fd64cd22f38af2c2503a11d8247be2090cd","subtreeSha":"3F00E848F43BF02694B8A1624156250B135178024B26922248B8F8685508E0C4","lastSyncedAt":"2026-09-25T07:37:25.617865Z"},"reviewedAt":"2026-09-08T12:08:02.753536Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/huangwb8/skills/tree/main/skills/alpha/compact-bensz-skills"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install huangwb8-skills@llmmart"},{"target":"git","command":"git clone https://github.com/huangwb8/skills.git"}]}