> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 实践者技能

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

本目录收集适合日常工作流和个人操作的 Codex 兼容技能。每个技能都应作为可安装的软件包使用，包含面向人的 `README.md`、面向 agent 的 `SKILL.md`，以及它真正需要的支持资源。

## 当前技能

| 技能                                | 包路径                                                                                                                                                                         | 展示内容                                                                             |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| Agent Runtime Cache Benchmark     | [`skills/agent-runtime-cache-benchmark/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/agent-runtime-cache-benchmark/README.md)         | 面向本地运行的冷启动与热启动对比、基于结构化运行产物的缓存断点识别，以及报告驱动的 prompt cache 调优                        |
| Daily News Watcher                | [`skills/daily-news-watcher/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/daily-news-watcher/README.md)                               | 基于 SQLite 的持久新闻监控、RSS/Atom 加可选 Playwright 抓取、URL+hash 去重，以及每次运行生成 Markdown 报告    |
| Garbage Collector                 | [`skills/garbage-collector/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/garbage-collector/README.md)                                 | 预览优先的本地清理、可读 CSV 规则、可撤销的重复文件清理，以及破坏性操作前的明确批准                                     |
| Local Document Organizer          | [`skills/local-document-organizer/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/local-document-organizer/README.md)                   | 预览优先的文件夹整理、带置信度评分的可读分类规则、带 action log 的可撤销移动，以及不删除、不覆盖的安全契约                      |
| Personal Knowledge Capture        | [`skills/personal-knowledge-capture/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/personal-knowledge-capture/README.md)               | 本地优先的 watch-path 注册、增量 source 检测、SQLite 状态，以及带引用的 Markdown 笔记生成                  |
| Prompt Cache Agent Harness        | [`skills/prompt-cache-agent-harness/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/prompt-cache-agent-harness/README.md)               | Claude prompt-cache 层规划、捕获的 usage metadata 审阅、cache-read/write 报告，以及可选的调用方输入成本估算 |
| Prompthon Social Campaign Manager | [`skills/prompthon-social-campaign-manager/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/prompthon-social-campaign-manager/README.md) | 通过已登录浏览器交接、local companion bridge token 交换、组织级 API 变更、媒体挂载与定时回读来完成生产级社媒运营        |
| Safety Escalation Review          | [`skills/safety-escalation-review/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/safety-escalation-review/README.md)                   | 本地证据审查、脱敏升级备忘录，以及由人工负责的安全交接清单，不执行外部报告                                            |

## 技能包结构

每个共享技能都应保持包本身小而清晰：

```text theme={null}
skills/<skill-name>/
  README.md
  SKILL.md
  agents/openai.yaml
  scripts/
  references/
```

使用 `README.md` 讲清面向人的故事：这个包为什么存在、适合谁、学生或操作者应先理解怎样的端到端工作流。使用 `SKILL.md` 放置 Codex 的调用契约。使用 `scripts/` 放置确定性的辅助工具，使用 `references/` 放置规则文件或支持性指南，使用 `agents/openai.yaml` 放置 UI 元数据。

## 贡献类型

Practitioner skill package 是代码加文档的贡献。一个包应包含面向人的 `README.md`、面向 agent 的 `SKILL.md`、agent 元数据、确定性脚本、参考规则，以及让技能可审查、可运行所需的最少支持文档。除非请求只修改解释性页面，否则不要把这类 issue 当成纯文档 issue。

## 贡献类型

Practitioner skill package 是代码加文档的贡献。一个包可以包含 Markdown 指令、agent 元数据、确定性脚本、参考规则，以及让技能可审查、可运行所需的最少支持文档。除非请求只修改解释性页面，否则不要把这类 issue 当成纯文档 issue。

## 实践者边界

Practitioner skills 应展示 Codex 执行能力强于普通聊天回答的地方：本地文件、持久规则、可重复工作流、浏览器或系统交互，以及明确的安全检查。