Agent Skill · 开发

compact-guide（紧凑指南）

compact-guide 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

compact-guide 是开发类 Agent Skill，可用宿主为 Codex、Claude、Cursor、Gemini CLI，通过GitHub 仓库获取，权限为需要联网；许可证信息还不明确，第三方扫描已通过，按安装量在开发类的 21,746 个 Skill 里排第 18,498。

总安装 333周安装 14GitHub Stars 117下载 116核验 2026-05-01

开发需要联网 GitHub 仓库未标认证来源可访问许可证需确认审计通过 Codex Claude Cursor Gemini CLI

安装说明

本站只整理中文说明，不托管安装包，也不代用户安装。

GitHub

许可证: unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：compact-guide（紧凑指南）
来源仓库：https://github.com/jh941213/my-claude-code-asset
仓库路径：skills/compact-guide
安装命令：
npx skills add https://github.com/jh941213/my-claude-code-asset --skill compact-guide
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills

npx skills add https://github.com/jh941213/my-claude-code-asset --skill compact-guide

这个 Skill 是做什么的

开发类 Skill 面向写代码、改代码和排查问题，一般会读写仓库文件，部分还会执行构建或测试命令。

compact-guide 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。

强调上下文管理如同新鲜牛奶般易变质的特点，建议在令牌达到 80-100k 前及时重置。推荐每完成 3-5 个任务就执行 /compact 压缩操作，配合 /clear 完全初始化保持高效工作环境。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

来源仓库内路径：skills/compact-guide

上手步骤

4 步

1
确认自己的宿主工具
公开资料标注支持 Codex、Claude、Cursor、Gemini CLI；先确认自己用的是其中之一，再按对应工具的 Skills 目录放置。
2
拿到安装命令
可以直接复制的命令是 npx skills add https://github.com/jh941213/my-claude-code-asset --skill compact-…；命令里的占位符换成自己的路径或密钥再执行。
3
安装后重启宿主
命令执行完要完全退出宿主工具再打开，让新装的 Skill 被重新扫描到，否则列表里可能看不到。
4
按最小权限试用
它需要需要联网，先在测试目录或测试账号里跑，确认没问题再放到正式项目。

常见问题

6 条

compact-guide 怎么安装？

在终端执行 npx skills add https://github.com/jh941213/my-claude-code-asset --skill compact-guide。装完完全退出宿主工具再打开，让它重新扫描本地 Skill。

compact-guide 支持哪些 AI 工具？

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录，一般也能手动放进去，但要自己确认触发方式是否一致。

compact-guide 需要什么权限？

权限级别是需要联网。该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

compact-guide 是免费的吗？

公开资料没有标注明确许可证，收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

compact-guide 用的人多吗？

公开数据是累计安装 333 次，近一周安装 14 次，下载 116 次，GitHub 117 星。这些数字来自第三方目录统计，只能当作热度参考，不代表质量或安全性。

compact-guide 安全吗？

第三方扫描结果为通过，但这只覆盖已知的静态检查项，不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

同时适配 4 种工具，换客户端不用重新找替代品。
第三方扫描已通过，常见的高风险行为没有命中。

先想清楚的地方

许可证没有明确标注，能不能商用、能不能再分发都不确定。
第三方目录整理，版本更新和行为细节以来源仓库为准。

适不适合你

更适合

已经在用 Codex，想直接扩展它能力的人。
需要处理开发类任务、又不想每次都手写提示词的人。

不太适合

需要明确授权才能用到公司项目里的场景。
需要厂商级技术支持和 SLA 的生产系统。

开发类 Skill 对比

6 个同类

Skill	总安装	GitHub 星	权限	许可证	扫描
skill-vetter 技能审查员 · OpenClaw	8,779,018	986	操作浏览器	MIT-0	通过
ontology 本体论 · OpenClaw	6,636,960	576	只读	MIT-0	通过
entra-app-registration 内部应用程序注册 · Codex、Claude	6,631,872	764	接触敏感数据	未明确	通过
entra-app-registration 内部应用程序注册 · Codex、Claude	3,757,680	201	接触敏感数据	未明确	通过
nano-banana-pro 纳米香蕉专业版 · OpenClaw	3,526,898	364	接触敏感数据	MIT-0	有提醒
compact-guide 紧凑指南 · 本页	333	117	需要联网	未明确	通过

按安装量取同分类前几名；数字来自第三方目录统计，只作热度参考，不代表质量结论。

SKILL.md 原文

컨텍스트 관리 가이드

컨텍스트는 신선한 우유와 같습니다. 시간이 지나면 상합니다.

핵심 규칙

토큰 80-100k 넘기 전에 리셋
3-5개 작업마다 컨텍스트 정리
/compact 3번 후 /clear

명령어

/compact

대화 내용을 요약해서 압축
중요한 정보는 유지, 토큰만 줄임
작업 흐름이 끊기지 않음

/clear

완전히 초기화
HANDOFF.md 없으면 위험!
깨끗하게 시작하고 싶을 때

권장 패턴

작업 시작
    ↓
3-5개 작업 완료
    ↓
/compact (토큰 압축)
    ↓
3-5개 작업 완료
    ↓
/compact
    ↓
3-5개 작업 완료
    ↓
/compact
    ↓
/handoff (HANDOFF.md 생성)
    ↓
/clear (초기화)
    ↓
새 세션에서 HANDOFF.md 읽기

주의

200k 토큰까지 쓸 수 있지만, 80-100k 넘으면 품질 저하!

캐시 관점의 컨텍스트 관리

/compact가 유리한 이유

시스템 프롬프트 + 도구 정의의 prefix 캐시가 유지됨
대화 메시지만 요약되므로 매 턴 캐시 히트 가능
/clear보다 비용이 크게 낮음

/clear의 숨겨진 비용

전체 prefix 캐시 무효화 (시스템 프롬프트 + 도구 + CLAUDE.md + rules/ 재계산)
HANDOFF.md 로드 시 추가 토큰 발생
다음 API 호출부터 캐시 워밍업 필요

Compaction 타이밍 가이드

50-70k 토큰: 첫 /compact (여유 있을 때 미리)
80-100k 토큰: 두 번째 /compact 또는 /handoff 준비
/compact 후에도 80k 이상이면: /handoff → /clear → 새 세션
150k 이상에서 compact하지 않기 (buffer 부족 위험)

平台分布

Codex

35.75%

按下载量换算41

Claude

30.05%

按下载量换算35

Cursor

18.25%

按下载量换算21

Gemini CLI

9.68%

按下载量换算11

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源，建议同时核对源仓库。

继续浏览同类 Skills

更多开发 Skills（21,746）返回 Skills 目录

上一个 Skill

compact（compact 搜索）

kelvinz/cobb

compact 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

compact-markdown（compact Markdown 控制）

nkootstra/skills

用于辅助文档、README、Markdown、说明文和内容稿件的整理与改写。它适合让 Agent 提炼结构、补齐章节、统一术语、检查链接或把零散材料整理成可读文档。使用时应保留项目已有事实、命令和路径，不要把未确认的信息写成确定结论；涉及对外文案时，还需要控制语气，避免过度营销或夸大能力。