# Offline Prompt Packager

> 把基于 prompts/ 主源的 skill 打包成断网单机可用的离线提示词包。Use when the user wants to export/package offline prompts for disconnected hosts (WebUI、Qwen、AnythingLLM、Claude.ai), generate self-contained system_prompt / user_prompt bundles, or build a per-文种 prompt.

- Skill: `zhaohui-yang/offline-prompt-packager` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zhaohui-yang/offline-prompt-packager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaohui-yang/offline-prompt-packager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: zhaohui-yang (https://skillmd.com/u/zhaohui-yang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhaohui-yang/offline-prompt-packager

---


# 离线提示词打包器

把一个基于 `prompts/` 主源的 skill 打包成**断网单机也能用**的提示词包——目标是只能粘贴提示词、装不了 skill 的宿主（WebUI / Qwen / AnythingLLM / Claude.ai）。

这是「打包」元能力，不改写规则：所有内容都从 `prompts/` 主源内联，保证离线包和在线 skill 同源、不漂移。

## 文件索引

```
src/adapters/offline/build.py        # 离线打包主入口（CLI）
src/adapters/shared.py               # render_offline_system_prompt 等共享渲染（在线/离线共用；再导出层，实现在同目录 paths/profiles/doc_types/rendering）
prompts/profiles/default.toml    # 离线 profile（system 分层、文种目录、兜底骨架）
prompts/core/*.md                # 共享总规则主源（离线内联）
dist/offline/<profile>/...       # 打包产物
```

## 调用方式

- 全量重建仓库内置离线产物：`python3 src/adapters/offline/build.py`（不传参=全文种）。
- 只出基础系统提示词：`--emit-system`。
- 按文种拼 `System + User` 完整提示词：`--doc-type <文种>`，可加 `--instruction`/`--material-file`/`--include-examples`。
- 指定 profile：`--profile default`（当前内置 `default` 一套）。
- 列出支持文种：`--list-doc-types`；写到单文件：`-o 输出.md`。

```bash
python3 src/adapters/offline/build.py                          # 全量重建
python3 src/adapters/offline/build.py --doc-type 通知 -o 通知-离线.md
```

## 默认流程

1. 选任务：基础 system（`--emit-system`）或按文种完整提示词（`--doc-type`）。
2. 生成后产物落 `dist/offline/<profile>/`；分发时整包提示词粘进宿主即可。
3. 改了 `prompts/` 主源后重新打包，保证离线包与在线 skill 同源。

## 复用到其它 skill

打包逻辑（system/user/profile 分层、内联主源）与公文内容无强绑定。把另一个 skill 的规则也组织成 `prompts/core/*` + `prompts/profiles/*.toml` + 文种/任务目录后，可复用本入口打包成离线提示词。

## 边界

- 离线包是「快照」：主源更新后必须重新打包，否则会和在线 skill 漂移。
- profile 机制保留可扩展（`prompts/profiles/` 下可再加 profile）；当前内置 `default` 一套。