ops-handbook — for Claude Code ops-handbook, pm-workspace-public, community, for Claude Code, ide skills, core.styles.C, #141413, #D97757, from core.styles import C, core.styles.FONT

v1.0.0
GitHub

关于此技能

适用场景： Ideal for AI agents that need ops-handbook skill（运营操作手册）. 本地化技能摘要： 升版 / patch（不重生 docx，原地改） 完全复用 PRD 升版纪律。from core.patch import 拿到 replace para text / insert heading before / insert paragraph before / insert description after / `remove ta This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

功能特性

ops-handbook Skill（运营操作手册）
PRD 是研发 / 评审看的需求源，运营手册是 运营 / 客服 / BD 上手干活时翻的步骤书 。受众、时序、模板都不同，独立成 skill。
触发条件 ：PRD 终稿 + 后台已有可截图功能 → 出运营手册
不触发 ：场景文档 / 需求文档（走 prd skill）；前端用户教学（不在 PM 工区）
基线参考 ：活动中心运营操作手册 v3（13 章实战版）

# 核心主题

for Claude Code core.styles.C #141413 #D97757 from core.styles import C core.styles.FONT
CaufieldZ CaufieldZ
[0]
[0]
更新于: 5/1/2026

Killer-Skills Review

Decision support comes first. Repository text comes second.

Reference-Only Page Review Score: 10/11

This page remains useful for teams, but Killer-Skills treats it as reference material instead of a primary organic landing page.

Original recommendation layer Concrete use-case guidance Explicit limitations and caution Quality floor passed for review
Review Score
10/11
Quality Score
61
Canonical Locale
zh
Detected Body Locale
zh

适用场景： Ideal for AI agents that need ops-handbook skill（运营操作手册）. 本地化技能摘要： 升版 / patch（不重生 docx，原地改） 完全复用 PRD 升版纪律。from core.patch import 拿到 replace para text / insert heading before / insert paragraph before / insert description after / `remove ta This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

核心价值

推荐说明： ops-handbook helps agents ops-handbook skill（运营操作手册）. 升版 / patch（不重生 docx，原地改） 完全复用 PRD 升版纪律。from core.patch import 拿到 replace para text / insert heading before / insert paragraph before / insert description

适用 Agent 类型

适用场景： Ideal for AI agents that need ops-handbook skill（运营操作手册）.

↓ 赋予的主要能力 · ops-handbook

适用任务： Applying ops-handbook Skill（运营操作手册）
适用任务： Applying PRD 是研发 / 评审看的需求源，运营手册是 运营 / 客服 / BD 上手干活时翻的步骤书 。受众、时序、模板都不同，独立成 skill。
适用任务： Applying 触发条件 ：PRD 终稿 + 后台已有可截图功能 → 出运营手册

! 使用限制与门槛

  • 限制说明： Requires repository-specific context from the skill documentation
  • 限制说明： Works best when the underlying tools and dependencies are already configured

Why this page is reference-only

  • - Current locale does not satisfy the locale-governance contract.

Source Boundary

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

评审后的下一步

先决定动作，再继续看上游仓库材料

Killer-Skills 的主价值不应该停在“帮你打开仓库说明”，而是先帮你判断这项技能是否值得安装、是否应该回到可信集合复核，以及是否已经进入工作流落地阶段。

安装路径

先进入安装与验证

如果这项技能值得继续，下一步应该先确认安装命令、CLI 写入路径与环境验证。
可信复核

回到可信合集再做一次复核

如果你还在比较不同技能或供应方，先回到可信合集做二次判断，而不是继续放大仓库噪音。
工作流

如果要进团队流转，转到工作流集合

当你的目标已经不是单个技能，而是团队协作、审批和可重复执行，就应该转到工作流合集继续比较。
实验室 Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

常见问题与安装步骤

以下问题与步骤与页面结构化数据保持一致，便于搜索引擎理解页面内容。

? FAQ

ops-handbook 是什么？

适用场景： Ideal for AI agents that need ops-handbook skill（运营操作手册）. 本地化技能摘要： 升版 / patch（不重生 docx，原地改） 完全复用 PRD 升版纪律。from core.patch import 拿到 replace para text / insert heading before / insert paragraph before / insert description after / `remove ta This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

如何安装 ops-handbook？

运行命令：npx killer-skills add CaufieldZ/pm-workspace-public。支持 Cursor、Windsurf、VS Code、Claude Code 等 19+ IDE/Agent。

ops-handbook 适用于哪些场景？

典型场景包括：适用任务： Applying ops-handbook Skill（运营操作手册）、适用任务： Applying PRD 是研发 / 评审看的需求源，运营手册是 运营 / 客服 / BD 上手干活时翻的步骤书 。受众、时序、模板都不同，独立成 skill。、适用任务： Applying 触发条件 ：PRD 终稿 + 后台已有可截图功能 → 出运营手册。

ops-handbook 支持哪些 IDE 或 Agent？

该技能兼容 Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer。可使用 Killer-Skills CLI 一条命令通用安装。

ops-handbook 有哪些限制？

限制说明： Requires repository-specific context from the skill documentation；限制说明： Works best when the underlying tools and dependencies are already configured。

↓ 安装步骤

  1. 1. 打开终端

    在你的项目目录中打开终端或命令行。

  2. 2. 执行安装命令

    运行：npx killer-skills add CaufieldZ/pm-workspace-public。CLI 会自动识别 IDE 或 AI Agent 并完成配置。

  3. 3. 开始使用技能

    ops-handbook 已启用，可立即在当前项目中调用。

! 参考页模式

此页面仍可作为安装与查阅参考，但 Killer-Skills 不再把它视为主要可索引落地页。请优先阅读上方评审结论，再决定是否继续查看上游仓库说明。

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Upstream Source

ops-handbook

安装 ops-handbook，这是一款面向AI agent workflows and automation的 AI Agent Skill。查看评审结论、使用场景与安装路径。

SKILL.md
Readonly
Upstream Repository Material
The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.
Supporting Evidence

ops-handbook Skill（运营操作手册）

PRD 是研发 / 评审看的需求源，运营手册是 运营 / 客服 / BD 上手干活时翻的步骤书。受众、时序、模板都不同，独立成 skill。

何时用 / 路由

  • 触发条件：PRD 终稿 + 后台已有可截图功能 → 出运营手册
  • 不触发：场景文档 / 需求文档（走 prd skill）；前端用户教学（不在 PM 工区）
  • 基线参考：活动中心运营操作手册 v3（13 章实战版）

美学规范（与 PRD 完全一致）

⛔ 禁止重新发明配色 / 字体 / 标题样式 / 表格列宽。全部走 PRD core/ 模块：

维度来源用法
配色core.styles.C（Anthropic Dark #141413 + terra cotta #D97757 + 表头 / 状态语义色）from core.styles import C
字体三件套core.styles.FONT（Lora / Poppins / Noto Serif SC / Noto Sans SC / JetBrains Mono）同上
标题样式core.headings 的 h1 / h2 / h3（terra cotta 下边框 / 左色块）from core.headings import h1, h2, h3
标点 / 字体 / theme 三件套core.normalizecheck_handbook.sh 调用
截图圆角 / DPIcore.images 的 round_phone_corners + fix_dpihandbook_screenshots.py 内置

check_handbook.sh 跑 PRD 同款字体三件套自检（缺 theme1.xml / 残留 Arial 即 fail）。

与 PRD 的关键区别

维度PRD运营手册
受众研发 / 评审 / 项目运营 / 客服 / BD
行文描述「做什么」描述「怎么操作」（动词开头：点击 / 选择 / 填入）
snake_case 字段名⛔ 禁，需白话化✅ 允许（运营要照着字段名找配置项）
像素值 / hex 色⛔ 禁，归设计稿✅ 允许（CMS 后台截图配置一致）
决策编号 / 版本痕迹⛔ 禁⛔ 同样禁（运营不关心 PM 内部决策）
不复用 humanize三道闸守住跳过 humanize；接受字段名 + 像素

章节模板

封面 + 元信息表（产品 / 版本 / 适用范围 / 维护人 / 更新日期）
├── 1. 模块概览                    什么系统 + 三方关系图 + C 端曝光位
├── 2. 角色与权限矩阵              三档 / 五档运营权限对照（谁能做什么）
├── 3. 核心操作流程                按用户旅程顺序：步骤 + 截图 + 异常态
│   ├── 3.x 操作 X
│   │   ├── 步骤 1：点击 ... → 看到 ... 截图
│   │   ├── 步骤 2：填入 ... → 校验规则 ...
│   │   └── ⚠️ 异常态：XX 时怎么办
├── 4. 字段定义                    枚举值 / 业务线 / 标签速查
├── 5. 故障排查（FAQ + 错误码）    高频问题 Q&A + 错误码索引
└── 6. 变更记录                    vs 上版差异

实际章节数随业务复杂度可扩到 10+（如活动中心 v3 有 13 章）。模板是骨架不是死规定。

详细章节定义：references/handbook-template.md 真实抽象示例：references/handbook-example.md

任务模式

A. 新建手册（gen_handbook_v{N}.py 路径）

Step 1 · Read：scene-list.md + PRD docx + 已上线后台 / CMS（拿到截图来源）+ handbook-template.md。

Step 2 · 收集：

  1. 产品名 + 版本号 + 维护人
  2. 受众（运营 / 客服 / BD / 多方）
  3. 章节优先级：核心操作流程 → 字段定义 → FAQ
  4. 截图源：CMS 路径 / 是否有 staging 环境

Step 3 · 分步生成 docx：脚本路径 projects/{项目}/scripts/gen_handbook_v{N}.py。

步内容行上限
3a 骨架init_doc + cover_page + 第 1-2 章（模块概览 + 角色权限矩阵）+ 各 H1 占位≤ 80 行
3b 按操作流程填 step_table每个核心操作一次 Write，全 step_table(doc, step_id, name, [(action, note, exception)])≤ 300 行/次
3c 收尾字段定义 + FAQ + 变更记录≤ 200 行

每次 Write 后 python3 gen_handbook_v{N}.py 跑通 + 验证 docx 打得开。

Step 4 · 截图（见 C）+ Step 5 · 自检（check_handbook.sh）+ Step 6 · 推 wiki（见 D）。

B. 升版 / patch（不重生 docx，原地改）

完全复用 PRD 升版纪律。from core.patch import * 拿到 replace_para_text / insert_heading_before / insert_paragraph_before / insert_description_after / remove_table。

字体三件套必跑（升旧 docx）：

python
1from core.normalize import normalize_punctuation, normalize_fonts, ensure_theme
2from core.headings import normalize_headings
3normalize_punctuation(doc)
4normalize_headings(doc)
5normalize_fonts(doc)
6doc.save(path)
7ensure_theme(path)

C. CMS 截图回填（handbook_screenshots.py）

bash
1python3 .claude/skills/ops-handbook/scripts/handbook_screenshots.py --project {项目名} \
2    --base-url https://mgt.example.com [--scenes step-1,step-2]

截图规范（与 PRD 一致）：

  • viewport 1440×900 + deviceScaleFactor 2 + PNG
  • fix_dpi(144) 防虚化（内置）
  • CMS 后台先 dismissAllOverlays → 截目标元素 / 全屏
  • 存放：screenshots/handbook/，升版 screenshots/handbook_v{N}/

⚠️ 登录 / cookie：CMS 通常有登录态。脚本支持 --cookie-file 读取 staging 环境的 sessionid，或先 playwright codegen 录脚本。

D. 推 Confluence

复用 PRD 的 push_to_confluence_base.py（mammoth + REST 是通用的，与内容类型无关）。必须加 --skip-self-check，因为 gate_check_quality 是 PRD 专属（扫圈数字 / 决策编号 / 1.3 流水账），运营手册不应被它拦：

bash
1python3 .claude/skills/prd/scripts/push_to_confluence_base.py \
2    "projects/{项目}/deliverables/handbook-{项目}-v{N}.docx" \
3    --page-id 155xxxxxx \
4    --skip-self-check

check_handbook.sh 替代 PRD gate 作运营手册质量门。

关联 Hook 矩阵

ops-handbook 不引入新 hook。复用现有 6 个：

hook拦什么触发
pre-wiki-push-gate.sh推 wiki 前未过 check_handbook.shBash 含 push_to_confluence_base.py 且 docx 名以 handbook- 开头
post-docx-screenshot-check.shdocx 改完截图过期Bash 跑 update_*.py
pre-deliverable-source-gate.sh直接 Edit/Write 已脚本化的 docxEdit/Write 命中 deliverables/handbook-*.docx
post-cjk-punct-check.sh中文旁半角 , : ( )Write/Edit

API 速查表

项目脚本开头：

python
1import sys
2from pathlib import Path
3BASE = Path(__file__).resolve().parents[3]
4sys.path.insert(0, str(BASE / '.claude/skills/prd/scripts'))      # 复用 PRD core/
5sys.path.insert(0, str(BASE / '.claude/skills/ops-handbook/scripts'))
6from gen_handbook_base import *

gen_handbook_base 提供（薄封装层）：

  • init_doc(landscape=False) / cover_page(doc, title, version, owner, audience, scope) — 运营手册默认竖版
  • h1 / h2 / h3 — 直接 re-export 自 core.headings
  • add_p / bullet / make_table / cell_text — 同上
  • step_table(doc, step_id, name, rows) — 三列步骤表（动作 / 校验 / 异常态），运营手册专属
  • field_table(doc, fields) — 字段定义表（字段名 / 类型 / 枚举值 / 含义），允许 snake_case
  • faq_block(doc, question, answer) — FAQ 单条（Q 粗体 + A 缩进段）
  • permission_matrix(doc, roles, capabilities) — 角色权限矩阵
  • save_handbook(doc, path) — 保存 + normalize_punctuation + normalize_fonts + ensure_theme（不调 humanize）
  • 颜色 / 字体直接 import：from core.styles import C, FONT

自检清单

  • 编号和 PRD 关联场景一致
  • 生成脚本已存 projects/{项目}/scripts/gen_handbook_v{N}.py
  • 角色权限矩阵覆盖所有出现的角色（不留「TBD」）
  • 每个操作步骤至少 1 张 CMS 截图（fix_dpi(144) 已修正）
  • FAQ 覆盖项目实际踩坑（不是套话填充）
  • 字段定义表枚举值穷举（业务线 / 标签 / 状态等）
  • 通过 bash .claude/skills/ops-handbook/scripts/check_handbook.sh <docx>：
    • 无圈数字 ①②③ 残留
    • 字体三件套（theme1.xml + 无 Arial run + Noto Sans SC 已用）
    • 无中文旁半角标点
    • 截图 DPI ≥ 130

相关技能

寻找 ops-handbook 的替代方案 (Alternative) 或可搭配使用的同类 community Skill？探索以下相关开源技能。

查看全部

openclaw-release-maintainer

Logo of openclaw
openclaw

本地化技能摘要： 🦞 # OpenClaw Release Maintainer Use this skill for release and publish-time workflow. It covers ai, assistant, crustacean workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 333.8k
⑂ 0
AI

widget-generator

Logo of f
f

本地化技能摘要： Generate customizable widget plugins for the prompts.chat feed system # Widget Generator Skill This skill guides creation of widget plugins for prompts.chat . It covers ai, artificial-intelligence, awesome-list workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

本地化技能摘要： The React Framework # Feature Flags Use this skill when adding or changing framework feature flags in Next.js internals. It covers blog, browser, compiler workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 138.4k
⑂ 0
浏览器

pr-review

Logo of pytorch
pytorch

本地化技能摘要： Usage Modes No Argument If the user invokes /pr-review with no arguments, do not perform a review . It covers autograd, deep-learning, gpu workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 98.6k
⑂ 0
开发者工具