feat: skills - add sop generator skill

This commit is contained in:
tukuaiai 2026-01-21 05:38:30 +08:00
parent 28f2dcfb4e
commit 273c2bb0a9
15 changed files with 509 additions and 2 deletions

3
.gitignore vendored
View File

@ -46,6 +46,9 @@ ENV/
*.log *.log
logs/ logs/
libs/external/tmux
libs/external/.tmux
# Data files (保留 prompts-library 数据) # Data files (保留 prompts-library 数据)
# *.csv # *.csv
# *.zip # *.zip

View File

@ -163,6 +163,8 @@ git push
│ │ │ └── 03-用户提示词/ # 用户自定义提示词 │ │ │ └── 03-用户提示词/ # 用户自定义提示词
│ │ └── skills/ # 技能库 │ │ └── skills/ # 技能库
│ │ ├── 00-元技能/ # 生成技能的元技能 │ │ ├── 00-元技能/ # 生成技能的元技能
│ │ │ ├── claude-skills/ # 元技能核心
│ │ │ └── sop-generator/ # SOP 生成与规范化技能
│ │ ├── 01-AI工具/ # AI CLI 和工具 │ │ ├── 01-AI工具/ # AI CLI 和工具
│ │ ├── 02-数据库/ # 数据库技能 │ │ ├── 02-数据库/ # 数据库技能
│ │ ├── 03-加密货币/ # 加密货币/量化交易 │ │ ├── 03-加密货币/ # 加密货币/量化交易
@ -198,6 +200,7 @@ git push
- `libs/external/prompts-library/main.py` - 提示词转换工具入口 - `libs/external/prompts-library/main.py` - 提示词转换工具入口
- `backups/一键备份.sh` - 备份脚本入口 - `backups/一键备份.sh` - 备份脚本入口
- `i18n/zh/skills/04-开发工具/tmux-autopilot/` - tmux 自动化操控技能(基于 oh-my-tmux含 capture-pane/send-keys/蜂群巡检脚本) - `i18n/zh/skills/04-开发工具/tmux-autopilot/` - tmux 自动化操控技能(基于 oh-my-tmux含 capture-pane/send-keys/蜂群巡检脚本)
- `i18n/zh/skills/00-元技能/sop-generator/` - SOP 生成与规范化技能(输入资料/需求 -> 标准 SOP
--- ---

View File

@ -332,6 +332,7 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
* [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。 * [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。
* [**通用项目架构模板**](./i18n/zh/documents/00-基础指南/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。 * [**通用项目架构模板**](./i18n/zh/documents/00-基础指南/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
* [**元技能Skills 的 Skills**](./i18n/zh/skills/00-元技能/claude-skills/SKILL.md): 用于生成 Skills 的元技能。 * [**元技能Skills 的 Skills**](./i18n/zh/skills/00-元技能/claude-skills/SKILL.md): 用于生成 Skills 的元技能。
* [**SOP 生成 Skill**](./i18n/zh/skills/00-元技能/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。
* [**tmux快捷键大全**](./i18n/zh/documents/02-方法论/tmux快捷键大全.md): tmux 的快捷键参考文档。 * [**tmux快捷键大全**](./i18n/zh/documents/02-方法论/tmux快捷键大全.md): tmux 的快捷键参考文档。
* [**LazyVim快捷键大全**](./i18n/zh/documents/02-方法论/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。 * [**LazyVim快捷键大全**](./i18n/zh/documents/02-方法论/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
* [**手机远程 Vibe Coding**](./i18n/zh/documents/02-方法论/关于手机ssh任意位置链接本地计算机基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。 * [**手机远程 Vibe Coding**](./i18n/zh/documents/02-方法论/关于手机ssh任意位置链接本地计算机基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。

View File

@ -0,0 +1,166 @@
---
name: sop-generator
description: "标准作业程序SOP生成与规范化将输入资料/需求/历史记录整理为可执行 SOP结构化章节、步骤、控制点、异常处理、记录。当用户要求“写 SOP/作业指导书/操作规程/流程说明”,或给出零散资料需要“整理成 SOP/流程”,或要求“按标准结构输出 SOP/质量检查”时使用。"
---
# sop-generator Skill
将碎片化资料与需求,转化为**可执行、可审核、可复用**的 SOP 文档,并输出统一结构与质量检查。
## When to Use This Skill
触发条件(满足任一即可):
- 明确要求:写 SOP / 标准作业程序 / 作业指导书 / 操作规程 / 流程说明
- 给出零散记录、聊天日志、需求清单,要求“整理成 SOP/流程”
- 要求“统一结构、含关键控制点/异常处理/记录表”的过程文档
## Not For / Boundaries
- 不替代**法律/医疗/高危工艺**的强制合规文件(需专业审核)
- 不凭空编造组织内部流程;缺失信息必须**显式追问**
- 不输出“只有结论、没有步骤”的说明书
## 必要输入(缺失则先问 1-3 个关键问题)
1. 目标与范围SOP 解决什么问题?适用于谁/哪些场景?
2. 关键产出:最终产物/结果是什么?验收标准如何定义?
3. 资源与约束:必需工具、系统权限、合规要求、时限/成本
## 工作流(高层步骤)
1. **拆解任务边界**:识别是否存在多个主题(需要拆分多份 SOP
2. **抽取操作链路**:把目标拆成“输入 → 动作 → 输出”的步骤序列
3. **标注控制点**:关键参数/质量阈值/安全风险
4. **补齐异常处理**:偏离标准时的应对与升级路径
5. **结构化输出**:按统一模板生成 SOP
6. **质量自检**:完整性、可执行性、可追溯性
## 输出结构(统一模板)
```
SOP 标题 / 文档编号
版本与修订记录
编制/审核/批准
1. 目的Purpose
2. 适用范围Scope
3. 术语与定义Definitions
4. 角色与职责Roles & Responsibilities
5. 资源与前置条件Resources/Prerequisites
6. 标准作业步骤Procedure
6.1 步骤 1输入/动作/输出/耗时)
6.2 步骤 2 ...
7. 关键控制点与质量标准Critical Control Points
8. 安全与风险提示Safety/Risk
9. 异常处理与升级路径Deviations/Escalation
10. 记录与表单Records
11. 相关文件/参考资料References
```
## Quick Reference
### Pattern 1: 一句话拆分判断
```text
如果输入里出现 >=2 个互不相关的目标/对象/系统,则拆分为多份 SOP否则合并为一份并在范围中声明。
```
### Pattern 2: 最小可行 SOPMVP
```text
目的 + 范围 + 资源 + 3-7 步骤 + 关键控制点 + 异常处理 + 记录
```
### Pattern 3: 步骤写法模板
```text
步骤N在[系统/地点]使用[工具]执行[动作],输入为[输入],输出为[输出],耗时/阈值为[参数]。
```
### Pattern 4: 缺失信息快速追问
```text
请补充1) 适用范围/角色 2) 关键产出与验收标准 3) 必需工具/系统权限
```
### Pattern 5: 一键生成 SOP 模板(脚本)
```text
python i18n/zh/skills/00-元技能/sop-generator/scripts/generate_sop.py --title "项目上线 SOP" --doc-id "SOP-001" --version "v1.0" --output sop.md
```
### Pattern 6: 生成最小可行 SOPMVP
```text
python i18n/zh/skills/00-元技能/sop-generator/scripts/generate_sop.py --title "巡检 SOP" --mvp --output sop-mvp.md
```
## 规则与约束
- MUST步骤必须可执行、可复现关键控制点必须量化
- SHOULD每个步骤都包含输入/动作/输出;异常处理明确负责人
- NEVER用“自行判断/视情况而定”替代关键步骤
## Examples
### Example 1从杂乱记录生成 SOP多主题拆分
- Input节选
- “SOP 的定义、SOP 标准结构”
- “mac 截屏到剪贴板快捷键”
- “obs 同时推流 2 平台”
- Steps
1) 识别为 3 个主题 → 拆分 3 份 SOP
2) 每份按模板输出,并在范围里声明适用平台
3) 对缺失信息(如 OS 版本/软件版本)提出追问
- Expected output / acceptance
- 3 份独立 SOP每份含步骤、控制点、异常处理
### Example 2需求驱动 SOP六爻因子生成
- Input
- 目标:用“六爻”作为唯一占卜流派
- 输出:方向、强度、置信、周期、原始卦象字段、解释
- 约束:不涉及个人八字
- Steps
1) 明确适用范围:仅物品/交易对/商品
2) 设计步骤链:采集对象 → 起卦 → 解析 → 量化映射
3) 定义关键控制点:字段一致性、量化尺度
- Expected output / acceptance
- SOP 中包含字段定义表、量化公式/区间、异常处理(如数据不足)
### Example 3基于仓库资料生成 SOP项目试玩/运行)
- Input
- GitHub 仓库BloopAI/vibe-kanban
- 目标:快速试玩项目
- Steps
1) 读取 README → 提取运行前置条件
2) 输出“本地启动 SOP”安装依赖、配置密钥、启动命令
3) 标注关键控制点API Key 必填、依赖管理工具
- Expected output / acceptance
- 1 份“本地运行 SOP”包含最少步骤与失败处理
## References
- `references/index.md`:导航与索引
- `references/sop-foundations.md`SOP 定义与核心特征
- `references/sop-structure.md`:通用结构与章节说明
- `references/writing-style.md`:写作与可执行性规范
- `references/repo-vibe-kanban.md`vibe-kanban 仓库摘要
- `references/examples.md`:长样例与原始输入片段
## Assets & Scripts
- `assets/sop-template.md`:全量 SOP 模板
- `assets/sop-mvp.md`:最小可行 SOP 模板
- `assets/record-log-template.md`:记录表模板
- `scripts/generate_sop.py`:模板生成脚本(支持全量/MVP
## Maintenance
- Sources: 官方/权威 SOP 资料 + 仓库 README见 references
- Last updated: 2026-01-20
- Known limits: 需按具体行业/合规要求补充细则
## Quality Gate
1. `description` 可触发且包含关键词SOP/作业指导书/操作规程)
2. 有明确的输入缺口追问策略
3. 输出结构包含控制点/异常处理/记录
4. 至少 3 个可复现示例
5. 参考资料独立拆分且可导航

View File

@ -0,0 +1,11 @@
# 记录表模板:{{title}}
| 字段 | 说明 | 示例 |
|:---|:---|:---|
| 记录编号 | 唯一标识 | SOP-2026-001 |
| 操作人 | 执行人 | 张三 |
| 操作时间 | 时间戳 | 2026-01-20 10:00 |
| 关键参数 | 量化参数 | 温度=120℃ |
| 结果 | 成功/失败 | 成功 |
| 异常说明 | 若有偏差 | 传感器延迟 |
| 处理动作 | 纠正措施 | 重新校准 |

View File

@ -0,0 +1,35 @@
# SOP 标题:{{title}}
文档编号:{{doc_id}}
版本:{{version}}
发布日期:{{date}}
---
## 1. 目的
(一句话说明目标)
## 2. 适用范围
(适用对象/场景)
## 3. 资源与前置条件
- 必需工具:
- 前置条件:
## 4. 标准作业步骤
1. 步骤 1输入 / 动作 / 输出 / 参数
2. 步骤 2
3. 步骤 3
## 5. 关键控制点与异常处理
- 关键控制点:
- 异常处理:
## 6. 记录
- 记录名称与保存方式:

View File

@ -0,0 +1,74 @@
# SOP 标题:{{title}}
文档编号:{{doc_id}}
版本:{{version}}
发布日期:{{date}}
编制:{{owner}} / 审核:{{reviewer}} / 批准:{{approver}}
---
## 1. 目的Purpose
(说明制定本 SOP 的目标与收益)
## 2. 适用范围Scope
(适用部门/岗位/系统/场景)
## 3. 术语与定义Definitions
(关键术语、缩写解释)
## 4. 角色与职责Roles & Responsibilities
- 角色 A
- 角色 B
## 5. 资源与前置条件Resources / Prerequisites
- 必需工具:
- 系统权限:
- 前置条件:
## 6. 标准作业步骤Procedure
### 6.1 步骤 1
- 输入:
- 动作:
- 输出:
- 参数/阈值:
- 预计耗时:
### 6.2 步骤 2
- 输入:
- 动作:
- 输出:
- 参数/阈值:
- 预计耗时:
## 7. 关键控制点与质量标准Critical Control Points
- 控制点 1阈值/标准/检验方法
- 控制点 2
## 8. 安全与风险提示Safety / Risk
- 风险点:
- 防护措施:
## 9. 异常处理与升级路径Deviations / Escalation
- 异常类型 → 处理动作 → 负责人 → 升级条件
## 10. 记录与表单Records
- 记录名称:
- 保存周期:
- 存放位置:
## 11. 相关文件/参考资料References
- 相关 SOP/制度:
- 外部规范:

View File

@ -0,0 +1,45 @@
# 长样例与原始资料
## 示例 A原始资料未清洗
> 说明:以下为混杂输入,用于测试“拆分多主题 + 追问缺失信息”能力。
```
历史记录
最近
SOP的定义
https://github.com/BloopAI/vibe-kanban 帮我分析这个项目怎么玩?
需求说明(简版) - 目标:用“六爻”作为唯一占卜流派,生成可量化的“测算因子”,用于物品/交易对/商品的分析(不涉及个人八字)。 - 输出要求:统一结构(方向、强度、置信、周期、原始卦象字段、解释
mac粘贴宝历史的快捷键
https://vscode.dev/tunnel/desktop-15prbve/Ubuntu/home/lenovo/.projects
pypl包是什么
https://x.com/EthRosamond/status/2011443034941268291?s=20
PS C:\Users\Docker> node --version v24.13.0 PS C:\Users\Docker> npm --version npm : 无法加载文件 C:\Pro
mac截屏到粘贴版
> Error: Authentication failed. Please log into Factory or set a valid FACTORY_API_KEY environment
root1@root1deMacBook-Pro ~ % npm i -g @openai/codex zsh: command not found: npm root1@root1deMacBook
加密货币量化交易的github仓库有哪些只要高星的
Overleaf这个有必要买吗
超高频策略策略相关的 的github开源框架仓库
核查事实;> 结论Binance Vision 不提供原始逐档盘口历史数据 | 数据类型 | Binance Vision | 说明 | |:---|:---|---|
还是无法连接到服务器;[01.07 06:24:39] obs64.exe - obsproject.com:443 open through proxy 127.0.0.1:9909 SOCKS5
OBS Studio 帮我找win11上能强制一个应用走代理的方法
obs如何同时推流2个平台
在win11上使用9910的代理启动obs 的命令是什么
```
## 示例 B输出骨架模板级
```
SOP 标题 / 编号 / 版本
1. 目的
2. 适用范围
3. 术语与定义
4. 角色与职责
5. 资源与前置条件
6. 标准作业步骤(输入/动作/输出)
7. 关键控制点与质量标准
8. 异常处理与升级
9. 记录与表单
10. 参考资料
```

View File

@ -0,0 +1,14 @@
# sop-generator Reference Index
## 快速入口
- SOP 基础定义:`sop-foundations.md`
- SOP 标准结构:`sop-structure.md`
- 写作与可执行性规范:`writing-style.md`
- 仓库样例:`repo-vibe-kanban.md`
- 长样例与原始资料:`examples.md`
## 说明
- 参考资料只放长内容与证据来源
- `SKILL.md` 保持可直接执行的简短模式

View File

@ -0,0 +1,17 @@
# 仓库摘要BloopAI/vibe-kanban
## 项目定位README 摘要)
- 项目是一个“live GPT task board”强调可用自然语言管理与执行任务
- 支持多模型供应商OpenAI / Anthropic
- 以本地优先为导向local-first
## 快速运行要点README 摘要)
- 安装依赖:`pnpm install`
- 启动开发:`pnpm dev`
- 需要配置模型供应商的 API Key
## 来源
- GitHub: https://github.com/BloopAI/vibe-kanban

View File

@ -0,0 +1,17 @@
# SOP 基础定义与价值
## 定义(权威来源摘要)
- SOP 是**书面文件**,用于描述对**经常/常规操作**的处理方式,目的是确保执行一致性与质量。
- SOP 的价值:把关键步骤写清楚,降低差异与错误,便于培训与审核。
## 常见价值(面向生产/服务/管理场景)
- 让不同人员在同一流程上保持一致结果
- 缩短新人上手时间、减少经验依赖
- 明确责任与记录,便于追溯与复盘
## 来源
- U.S. EPA Quality Management Tools - Standard Operating Procedures
https://www.epa.gov/quality/epa-quality-management-tools-standard-operating-procedures

View File

@ -0,0 +1,24 @@
# SOP 标准结构与章节要点
## 通用结构(合并多来源的常见章节)
1. **文档控制信息**:标题/编号、版本、修订记录、审批
2. **目的Purpose**
3. **范围Scope**
4. **术语与定义Definitions**
5. **职责Responsibilities**
6. **程序/步骤Procedures**
7. **记录与表单Records / Forms**
8. **参考资料References**
> 不同行业/机构会有不同细分,但以上内容是高频核心块。
## 来源摘记
### Boston University SOP Appendix结构清单
- 包含 Purpose/Scope、References、Definitions、Responsibilities、Procedures、Records/Forms、Additional Considerations
https://www.bu.edu/tech/files/2020/04/BU-ISCII-SOP-Appendix-2020.pdf
### U.S. FDA SOP Template章节目录
- 列出 Purpose、Scope、Policy、Responsibility、Procedures、References、Definitions、Exhibit、Revision History、Approval
https://www.fda.gov/media/111941/download

View File

@ -0,0 +1,21 @@
# 写作与可执行性规范(经验性建议)
> 以下为可执行性写作经验,用于提升 SOP 的可读性与一致性。
## 结构化写法
- 每一步都写成“输入 → 动作 → 输出”
- 统一编号与层级,避免超过 3 层缩进
- 关键参数必须量化(时间、温度、阈值、比例、范围)
## 语言风格
- 使用祈使句与主动语态
- 避免“视情况而定/自行判断”等模糊表述
- 关键控制点明确责任人/岗位
## 质量自检
- 是否有遗漏的前置条件或依赖
- 是否存在需要主观判断的关键步骤
- 是否能被新人在 30 分钟内执行并得到一致结果

View File

@ -0,0 +1,74 @@
#!/usr/bin/env python3
import argparse
from datetime import datetime
from pathlib import Path
def load_template(template_path: Path) -> str:
return template_path.read_text(encoding="utf-8")
def render_template(template: str, values: dict) -> str:
rendered = template
for key, value in values.items():
rendered = rendered.replace(f"{{{{{key}}}}}", value)
return rendered
def build_arg_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(
description="生成 SOP 模板(全量/最小版),输出到文件或标准输出"
)
parser.add_argument("--title", required=True, help="SOP 标题")
parser.add_argument("--doc-id", default="SOP-000", help="文档编号")
parser.add_argument("--version", default="v1.0", help="版本号")
parser.add_argument("--date", default=None, help="发布日期(默认今天)")
parser.add_argument("--owner", default="未指定", help="编制人")
parser.add_argument("--reviewer", default="未指定", help="审核人")
parser.add_argument("--approver", default="未指定", help="批准人")
parser.add_argument(
"--mvp",
action="store_true",
help="使用最小可行 SOP 模板MVP",
)
parser.add_argument(
"--output",
default="-",
help="输出路径,使用 '-' 表示标准输出",
)
return parser
def main() -> None:
args = build_arg_parser().parse_args()
script_dir = Path(__file__).resolve().parent
assets_dir = script_dir.parent / "assets"
template_file = assets_dir / ("sop-mvp.md" if args.mvp else "sop-template.md")
if not template_file.exists():
raise FileNotFoundError(f"找不到模板文件: {template_file}")
date_value = args.date or datetime.now().strftime("%Y-%m-%d")
values = {
"title": args.title,
"doc_id": args.doc_id,
"version": args.version,
"date": date_value,
"owner": args.owner,
"reviewer": args.reviewer,
"approver": args.approver,
}
template = load_template(template_file)
rendered = render_template(template, values)
if args.output == "-":
print(rendered)
return
output_path = Path(args.output)
output_path.write_text(rendered, encoding="utf-8")
if __name__ == "__main__":
main()

View File

@ -1,6 +1,6 @@
# 🎯 AI Skills 技能库 # 🎯 AI Skills 技能库
`i18n/zh/skills/` 目录存放 AI 技能Skills这些是比提示词更高级的能力封装可以让 AI 在特定领域表现出专家级水平。当前包含 **18 个**专业技能。 `i18n/zh/skills/` 目录存放 AI 技能Skills这些是比提示词更高级的能力封装可以让 AI 在特定领域表现出专家级水平。当前包含 **19 个**专业技能。
## 目录结构 ## 目录结构
@ -9,7 +9,8 @@ i18n/zh/skills/
├── README.md ├── README.md
├── 00-元技能/ # 元技能(生成 Skills 的 Skills ├── 00-元技能/ # 元技能(生成 Skills 的 Skills
│ └── claude-skills/ # ⭐ 元技能核心 │ ├── claude-skills/ # ⭐ 元技能核心
│ └── sop-generator/ # SOP 生成与规范化
├── 01-AI工具/ # AI CLI 和工具 ├── 01-AI工具/ # AI CLI 和工具
│ ├── canvas-dev/ # ⭐ Canvas白板驱动开发AI架构总师 │ ├── canvas-dev/ # ⭐ Canvas白板驱动开发AI架构总师
@ -43,6 +44,7 @@ i18n/zh/skills/
| 技能 | 说明 | | 技能 | 说明 |
|:---|:---| |:---|:---|
| [claude-skills](./00-元技能/claude-skills/SKILL.md) | ⭐ 生成 Skills 的 Skills | | [claude-skills](./00-元技能/claude-skills/SKILL.md) | ⭐ 生成 Skills 的 Skills |
| [sop-generator](./00-元技能/sop-generator/SKILL.md) | SOP 生成与规范化 |
### 01-AI工具 ### 01-AI工具