# CueBox

**Repository Path**: the50w/cue-box

## Basic Information

- **Project Name**: CueBox
- **Description**: 提示词与 SOP 资产库的唯一规范文件，按多视角组织，兼容 OKF v0.2
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-21
- **Last Updated**: 2026-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 提示盒 CueBox

[English](README.md) | **中文** | [Español](README.es.md)

> 公司内部的提示词与 SOP 资产库，按**视角**组织而不是按岗位堆提示词，兼容 OKF v0.2。本文件只是人读入口，
> **唯一规范一律以 [AGENTS.md](AGENTS.md) 为准**。

同一批提示词在提示盒里可以从不同角度看：默认的 **SOP** 视角按公司业务「输入 → 输出」的完整过程分解（战略 →
市场 → 销售 → 交付 → 回款 → 客户成功 → 研发 → 支撑），任何其它角度（岗位、场景、工具与模型、行业、风险等级……）
都可以再开一个视角。外部开源提示词库以只读子模块放在 `Libraries/`。

## 里面有什么

- **Views/** — 视角层，一个视角一个目录。`Views/SOP/` 是默认主线：`阶段 → 流程 → SOP` 三层，
  每个 SOP 按需放 `prompt.md` / `checklist.md` / `script.py` / `examples/`。
- **Libraries/** — 外部开源提示词库（LangGPT、wonderful-prompts、best-prompts），只读子模块，不纳入 OKF 扫描。
- **docs/** — 多语言人读文档（英文主版 + 中文 + Español），入口在 [docs/index.md](docs/index.md)。
- **归档/** — 废弃内容只归档，不删除。

## 快速上手

```bash
# 合规检查（查 frontmatter、链接、编码 —— 不查内容对不对）：
python "Views/SOP/00_战略与治理/知识管理/OKF合规检查/script.py"    # 退出码 0 = 通过
```

- **找 SOP**：从 [Views/SOP/index.md](Views/SOP/index.md) 逐层往下找；或直接用
  [提示词装配器](Views/SOP/00_战略与治理/知识管理/提示词装配器/index.md) —— 零依赖的本地网页工具，
  勾选多条 SOP 组合成一份完整提示词。
- **把会话变成资产**（最常用的日常操作）：从会话记忆里提炼可复用做法，判断该新建 SOP 还是补进已有 SOP ——
  方法见 [会话提炼/prompt.md](Views/SOP/00_战略与治理/知识管理/会话提炼/prompt.md)。

### 发起会话提炼

对 Agent 说一句：

> 把最近会话记忆里反复出现的做法提炼成 SOP。已有的按「完善」处理，指明补哪个文件、补什么。

两个可选限定，不补就用默认：**范围**（默认全库查重，例 `只看研发流程`）、**落点**（默认由 Agent 判断，例
`补到 Views/SOP/70_产品与研发/研发流程/`）。给了落点就以落点为准。

Agent 会走五步：**找重复**（同一套结构独立出现 2 次以上）→ **判类型**（流程 SOP / 提示词片段 / 项目知识 /
一次性事件，类型决定落点）→ **查重**（检索各级 `index.md`，命中就「完善」不「新建」）→ **提炼**（去专有名词、
变量化、保留真实案例，完善只追加不覆盖）→ **登记**（frontmatter + `index.md` + `log.md`，拿不准的写
`**待验证**`）。

两个判据：**够格靠「重复」，不靠「精彩」**；**去掉项目专有名词之后还立得住吗** —— 去掉就散架的（编译器坑、
渲染器限制、内部路径规则）是项目知识，不要塞进流程 SOP。

产出是一张判定表加三行结论：**建议新建** / **建议完善**（补案例 → `examples/`，补检查项 → `checklist.md`，
补判定 → `prompt.md`）/ **建议不沉淀**。一条纪律：**不要为了「有产出」而硬造 SOP**，凑出来的 SOP 会让整个库贬值。

提炼完你要做三件事：

1. **抽查落点**：文件是否真在正确的 SOP 下；各级 `index.md` 与 `log.md` 是否都更新了。
2. **人复核后补信任层**：Agent 的 `verified` 只有 `process:cuebox-okf-lint` 一条，只声明「机器检查过」，
   **不代表内容对**。看过之后**追加**一条 `human:<你的id>`，不要替换掉进程那条 —— 两条记录代表两次独立确认。
3. **跑合规检查**（退出码 `0` = 通过；只查 frontmatter/链接/编码，**不查**内容对错）：

```bash
python "Views/SOP/00_战略与治理/知识管理/OKF合规检查/script.py"
```

真实案例：[从 6 条会话记忆提炼出 3 个 SOP](Views/SOP/00_战略与治理/知识管理/会话提炼/examples/研发流程三个SOP的提炼过程.md)

## 内置工具：提示词装配器

[提示词装配器](Views/SOP/00_战略与治理/知识管理/提示词装配器/index.md) 是本仓库自带的辅助工具 —— 零依赖的本地网页应用，
把一条或多条 SOP 组合成一份完整提示词：左侧勾选 SOP、右侧填生成的表单（每个字段带 ✨ AI 代填按钮）、可选
**包含原始 SOP 路径**（贴绝对路径而不是提炼做法），生成后直接复制。双击仓库根目录的 `启动提示词装配器.bat`
（或运行 `python "Views/SOP/00_战略与治理/知识管理/提示词装配器/start.py"`）即可无黑窗桌面窗口打开；语言、
模型 API 与 Key 可配置，Key 只存浏览器 Cookie。

## 仓库地图

| 路径 | 是什么 |
| :--- | :--- |
| [AGENTS.md](AGENTS.md) | 唯一规范：结构、命名、OKF v0.2 兼容、元数据、AI 行为准则 |
| [index.md](index.md) | 根导航（携带 `okf_version: "0.2"`） |
| [log.md](log.md) | 全局变更日志 —— 每次有意义的修改都在这里记录 |
| [docs/index.md](docs/index.md) | 文档索引：仓库组织、OKF 元数据、合规检查、内容维护，每篇英 / 中 / 西三语 |
| [Views/SOP/](Views/SOP/index.md) | 默认视角：业务阶段 00–99 |
| [Libraries/](Libraries/index.md) | 外部库（只读子模块） |
| [归档/](归档/index.md) | 废弃内容 |

## 两条最容易踩的

- **不直接删除内容**：把 `status` 改成 `deprecated`，移入 `归档/已废弃/`（或 `Views/SOP/99_归档/已废弃/`）。
- **非保留 `.md` 必须带 frontmatter 且 `type` 非空**。根 README 家族是唯一例外，见 [AGENTS.md](AGENTS.md) §四。

## 已知限制

- 本 bundle **不是完全合规的 OKF v0.2 bundle —— 这是明知且接受的选择**：根 README 家族不带 frontmatter
  （纯人读入口，[AGENTS.md](AGENTS.md) §四）。除此之外全部通过合规脚本；脚本查什么、不查什么见
  [合规检查](docs/conformance.md)。

## 文档

完整文档在 [docs/](docs/index.md)，全部为 **English / 中文 / Español** 三语：

| 主题 | 覆盖内容 |
| :--- | :--- |
| [仓库组织](docs/repository.md) | 视角体系、SOP 三层结构、命名、落位规则 |
| [OKF 元数据](docs/okf-metadata.md) | frontmatter 字段、actor 约定、信任层、`verified` 语义 |
| [合规检查](docs/conformance.md) | 检查脚本怎么跑、查什么、已知局限 |
| [内容维护](docs/contributing.md) | 新增 / 修改 / 废弃 SOP、会话提炼、日志登记 |

> 本库的一条底线：**机器确认 ≠ 人复核**。过了检查脚本只证明「形式合法」，内容对不对仍需一条 `human:` 复核记录。