一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | session-guard-adit-jain-srm-skill-forge | 合集仓库子目录名（见下方说明） |
| 所属合集仓库 | Adit-Jain-srm/skill-forge（个人开发者维护的 18 个行为类技能合集，每个技能解决一个独立命名的问题，另含一套自我优化的技能路由与发现机制） | GitHub |
| 项目自述名称 | skill-forge | README |
| 作者/维护者 | Adit Jain（个人开发者） | GitHub |
| 来源链接 | https://github.com/Adit-Jain-srm/skill-forge/tree/main/skills/session-guard | — |
| 许可证 | MIT | GitHub API（LICENSE 文件已核实） |
| 所属仓库整体 Stars/Forks | 1 / 0（注：该数字属整个合集仓库，不代表本技能自身热度；该内容经改写后另被 wshobson/agents——一个 38,000+ star 的多 harness 技能市场——审核收录为独立组件） | GitHub API |
| 最新版本 | skill-forge v1.2.0（2026-06-06） | CHANGELOG.md |
| 最近提交 | 2026-06-28 | GitHub API |
| 安装方式 | 见第十章 | 官方 README |
二、功能介绍与亮点
Session Guard 是一份纯行为规范类技能，专门应对 agent 长会话中的两类隐蔽退化：
- 长会话腐化：工具调用超过 40～60 次后，agent 容易出现虚构工具结果、重复回声、以“已完成”敷衍未完成工作等问题
- 上下文压缩失忆：触发
/compact或自动压缩后，早期约定的命名规范、架构规则等会被无声丢弃，agent 在不自知的情况下带着“退化的心智模型”继续工作
技能给出一套三色健康信号表（绿/黄/红区间，以工具调用数与规则漂移信号为阈值）与对应协议：黄区检查点复述关键规则，红区停止操作并生成交接文档、建议开新会话。针对压缩场景，另给出“压缩安全模式”——把关键指令放进文件（如 CLAUDE.md）而非依赖对话记忆，因为文件内容在压缩后可被重新读取，对话中约定的规则则不能。
亮点：①零依赖——纯 Markdown 行为约定，不安装任何包、不连数据库、不调用外部服务；②给出具体量化阈值（40/60 次工具调用）而非模糊的“感觉长了”，可操作性强；③正面回应了“钩子解决不了这个问题”——技能正文引用了三个真实的 GitHub 平台议题编号，说明其设计建立在对已知失败模式的调研之上，而非凭空猜测；④所属 skill-forge 合集的核心内容后来被 wshobson/agents（多 harness 技能市场）审核后改写收录为独立插件的组成部分。
三、适用场景
固定分类：元技能与 Agent 增强（判定依据见审计记录）
适用于：正在用 Claude Code、Codex 等 agent 执行复杂多步任务、预计会话会变长的开发者；已经注意到 agent 开始“忘事”、风格漂移或输出质量下降，想知道该不该拆分会话的用户；每次触发上下文压缩（/compact）后担心早期规则被丢弃、想有一套自查流程的用户。受益人群：初中级开发者尤其容易在长会话里察觉不到“温水煮青蛙”式的质量下滑，这份技能把隐性信号显性化，降低了排查成本。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 仓库含 .claude-plugin 目录，README 提供 /plugin marketplace add 官方插件市场安装方式 |
| Codex CLI | 原生支持 | 仓库含 .codex-plugin 目录，README 提供克隆后拷贝至 ~/.codex/skills/ 的原生安装方式 |
| OpenClaw | 支持（经通用安装器） | 通用技能安装器 vercel-labs/skills（README 本身即以 npx skills@latest add 作为首选安装方式）明确列出 openclaw 目标路径 ~/.openclaw/skills/ |
| Hermes Agent | 支持（经通用安装器） | 同上，该安装器 README 同样列出 hermes-agent 目标路径 ~/.hermes/skills/ |
五、推荐理由
长会话质量退化是 agent 使用中一个真实但很少被系统化应对的问题——大多数用户只能凭感觉判断“是不是该开新会话了”，而上下文压缩后规则被静默丢弃更是完全无感知。Session Guard 不依赖钩子或额外基础设施，用一份可复制的行为准则把“何时该警惕、该做什么”变成可执行的清单，安装成本几乎为零却能直接改善长任务的稳定性，适合任何用 Claude Code / Codex 处理多步骤任务的用户常驻使用。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 4 | 所属仓库仅 1 star，个人项目，暂无可归因的独立第三方讨论；但其内容经改写后被 wshobson/agents（38,000+ star 的技能市场）审核收录为独立插件组件，说明经过了同行评审，非纯自我宣称 |
| 可用性 | 9 | 单文件、零依赖、复制即用；README 分别给出 Claude Code/Cursor/Codex/Gemini 等多种安装路径；最近一次实质性维护为 2026-06-28 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 7.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 无——纯 Markdown 行为规范，不含随安装自动执行的脚本 |
| ② 运行时联网外发数据 | 无——纯提示词内容，不发起网络请求 |
| ③ API Key/凭据要求 | 无需任何凭据 |
| ④ 可疑指令/Prompt Injection 迹象 | 未发现——已完整抓取全文，内容为行为准则与阈值表，无隐蔽指令 |
| ⑤ 作者/组织信誉 | Adit Jain，公开身份，仓库含完整 CHANGELOG 与自动化测试基础设施，无刷星或虚假宣传迹象 |
| ⑥ License 是否明确 | MIT，已核实 LICENSE 文件原文 |
| ⑦ 最近维护时间 | 2026-06-28，约六周前，无弃置迹象 |
七、跟同类 Skills 相比的优势
| 维度 | Session Guard（本推荐） | planning-with-files | Token Optimizer |
|---|---|---|---|
| 核心机制 | 行为自律：健康信号监测 + 阈值触发 + 规则复述锚定 | 状态持久化：把计划进度写入磁盘三个文件 | 内容压缩：系统性精简上下文占用并量化验证节省效果 |
| 解决的问题 | “会话是否在悄悄腐化、规则是否被压缩丢弃” | “上下文清空或崩溃后如何原地续接” | “上下文吃紧、token 浪费在哪里” |
| 是否需要额外文件/工具 | 否，纯行为约定 | 是，依赖三个固定结构的磁盘文件 | 视实现方式而定 |
| 适合场景 | 任何多步骤长会话，作为持续性的自我体检 | 明确需要跨会话续接同一任务进度的场景 | 频繁触达上下文上限、需要量化压缩效果的场景 |
三者可以配合使用而非互斥：Token Optimizer 解决“如何少占用上下文”，planning-with-files 解决“任务状态如何跨会话保留”，Session Guard 解决“如何察觉退化正在发生、该在什么时候主动拆分”——分别对应上下文管理的效率、持久化、健康监测三个不同切面。
八、用户评价
该技能目前在第三方平台尚无具名用户评价。其所属 skill-forge 合集向 wshobson/agents 提交的收录申请（Issue #570）经过 9 轮评论与 1 轮代码评审、历时近一个月后被采纳收录，评审过程中的意见主要为格式适配，未见对内容本身的实质性质疑，可作为该技能内容经过外部同行审视的旁证。
九、其他补充
skill-forge 合集另含一套“自我优化”机制（基于 TF-IDF 的技能路由、SkillOpt 自我改进循环），但该机制不属于 session-guard 本身，安装单个技能时不会引入这部分复杂度。合集整体带有 104 项自动化测试与 0 项校验警告，显示仓库工程规范性较好。
十、安装使用方式
方式一：只装这一个技能（推荐，手动拷贝）
git clone https://github.com/Adit-Jain-srm/skill-forge.git
cp -r skill-forge/skills/session-guard ~/.claude/skills/session-guard # Claude Code
# Codex CLI 拷贝至 ~/.codex/skills/，其他 agent 拷贝至对应 skills 目录方式二：通用安装器（适配 Claude Code / Cursor / OpenClaw / Hermes Agent 等）
npx skills@latest add Adit-Jain-srm/skill-forge方式三：Claude Code 插件市场（会连带安装整个 skill-forge 合集）
/plugin marketplace add Adit-Jain-srm/skill-forge
/plugin install skill-forge@skill-forge安装后由 agent 按需自动加载：当会话进行到较多工具调用轮次、agent 出现前后矛盾、或刚发生上下文压缩时触发，无需重启、无需额外配置。
十一、注意事项
- 方式二、方式三会连带安装 skill-forge 合集内的全部 18 个技能，若只想要会话健康监测这一项，建议用方式一单独拷贝
- 本技能纯粹依赖 agent 自身遵守文中约定的行为准则生效，不具备强制力（不同于代码层面的钩子拦截），实际效果取决于 agent 对指令的服从程度
- 目前由 Adit Jain 个人维护，虽有 wshobson/agents 的独立审核收录作为外部验证，仍建议关注后续维护连续性
- OpenClaw / Hermes Agent 的支持依赖第三方通用安装器 vercel-labs/skills，未在作者官方文档中直接验证