BP Manager（读 + 审计）

BP 管理助手 — 查看/管理自己与下级的BP，AI质量检查（基于康哲规则）

---

角色定位

BP Manager 是面向管理者和员工的 BP 日常管理工具，本技能承载只读查询 + AI 审计检查能力：

1. 1. BP 查看：查看自己或下级的 BP（目标/关键成果/关键举措）
2. AI 检查：基于康哲规则检查 BP 质量（结构/承接/衡量标准）
3. 汇报查看：查看任务关联的汇报历史
4. 搜索功能：按名称搜索任务或分组
5. 月度汇报查询：按分组+月份查询月度汇报
6. 下级BP建议：为下级的 BP 提供改进建议

写入能力（新增KR/新增举措/延期提醒）已拆分至 INLINECODE0

---

核心场景

场景一：查看 BP

用户意图：快速了解 BP 全貌

触发词：

• - "查看我的 BP"
• "查看下属的 BP"
• "查看产品中心的 BP"

执行流程：

1. 1. 识别用户身份（通过员工ID）
2. 获取周期列表，选择当前周期
3. 获取分组树，定位到目标分组
4. 调用 getGroupMarkdown 获取完整 BP
5. 格式化输出给用户

示例：

用户：查看我的 BP
助手：正在获取您的 BP...
[输出 Markdown 格式的 BP 内容]

---

场景二：AI 检查 BP

用户意图：检查 BP 是否符合康哲规则

触发词：

• - "检查我的 BP"
• "BP 质量检查"
• "帮我检查一下这个 BP"
• "审计 BP"

执行流程：

1. 1. 获取目标 BP 内容（Markdown 格式）
2. 基于康哲规则进行检查：

- 结构完整性：是否按 G-R-A 三层拆解
- 承接关系：下级目标是否承接上级关键举措
- 衡量标准：是否符合 SMART 原则
- 层级深度：是否符合所在层级要求

1. 3. 输出检查结果和改进建议

检查规则（来自 references/kangzhe-rules.md）：

• - 集团层级：拆解到 2 层（目标 → 关键成果）
• 中心/部门/员工层级：拆解到 3 层（目标 → 关键成果 → 关键举措）
• 衡量标准：必须包含指标/阈值/口径/数据源/统计频率
• 承接规则：下级目标承接上级关键成果/关键举措

示例：

用户：检查我的 BP
助手：正在检查您的 BP...

检查结果：
✅ 结构完整性：通过（3层结构完整）
✅ 承接关系：通过（目标承接了上级关键举措）
⚠️ 衡量标准：关键成果 1.2 缺少数据源
✅ 层级深度：通过（符合部门层级要求）

建议：
- 为关键成果 1.2 补充数据源信息

---

场景三：下级 BP 建议

用户意图：为下级的 BP 提供创建关键举措的建议

触发词：

• - "帮我看看下属的 BP"
• "给下级提点建议"
• "为下属的 BP 提建议"

执行流程：

1. 1. 获取下级 BP 内容
2. 分析 BP 内容，识别：

- 哪些关键成果缺少关键举措
- 哪些关键举措过于空泛，需要拆解
- 哪些关键举措缺少承接人

1. 3. 基于分析结果，生成改进建议
2. 输出建议列表

示例：

用户：帮我看看张三的 BP，给他提点建议
助手：正在分析张三的 BP...

建议为张三的 BP 改进以下内容：

**关键成果 1.1：客户拜访量达到50家**
- 建议新增举措：建立拜访记录系统，记录每次拜访的详细信息
- 建议新增举措：制定月度拜访计划，明确每周拜访目标

**关键成果 1.2：签约客户数达到20家**
- 建议新增举措：重点客户专项跟进，建立客户档案
- 建议新增举措：每周五回报跟进进度，及时调整策略

如需创建这些关键举措，请使用写入技能 cms-bp-manager-write

---

场景四：查看汇报历史

用户意图：查看某个任务关联的汇报历史

触发词：

• - "查看目标 X 的汇报历史"
• "这个任务的汇报记录"

执行流程：

1. 1. 识别目标任务
2. 调用 pageAllReports 接口（支持时间范围过滤）
3. 格式化输出汇报列表

示例：

用户：查看目标 A4-1 的汇报历史
助手：正在获取汇报历史...

目标【A4-1】的汇报历史（共5条）：

1. 手动汇报 - 2026-03-10
   - 标题： Q1 进度汇报
   - 业务时间： 2026-03-08

2. AI汇报 - 2026-03-05
   - 标题： AI进度分析
   - 业务时间： 2026-03-01

...

---

场景五：搜索任务

用户意图：按名称搜索 BP 任务

触发词：

• - "搜索关于客户拜访的任务"
• "找一下包含'全栈'的任务"

执行流程：

1. 1. 识别搜索关键词
2. 确定搜索范围（分组ID）
3. 调用 searchTaskByName 接口
4. 输出搜索结果

示例：

用户：搜索关于客户拜访的任务
助手：正在搜索...

找到 2 个相关任务：

1. 【关键成果】客户拜访量达到50家
   - 分组： 技术部
   - 状态： 进行中
   - 承接人： 张三

2. 【关键举措】每周拜访5家客户
   - 分组： 技术部
   - 状态： 进行中
   - 承接人： 李四

---

场景六：查询月度汇报

用户意图：按分组+月份查询月度汇报

触发词：

• - "查看3月份的月度汇报"
• "月度汇报查询"

执行流程：

1. 1. 确认分组ID和汇报月份（YYYY-MM）
2. 调用 getMonthlyReportByMonth 接口
3. 格式化输出月度汇报内容

---

写入能力（已拆分）

以下场景已拆分至 cms-bp-manager-write，本技能不再承载：

• - 新增关键成果：为某个目标添加新的关键成果 → INLINECODE7
• 新增关键举措：为某个关键成果添加关键举措 → INLINECODE8
• 延期提醒：向指定员工发送延期提醒 → INLINECODE9

---

环境变量

变量名	说明	获取方式
BPAPPKEY	BP 系统 API 密钥	从玄关开放平台获取

自动更新检查（每次运行 commands.py 默认启用）

变量名	说明
BPMANAGERSKIPUPDATECHECK	设为 1/true/yes 时跳过更新检查
BPMANAGERPROMPT_UPDATE

设为 1/true/yes 时检测到新版本会提示是否更新（仅 TTY 生效） | | BPMANAGERAUTO_UPDATE | 设为 1/true/yes 时检测到新版本自动执行更新命令 |

更新命令固定为：npx clawhub@latest install cms-bp-manager --force

---

API 接口清单

本技能使用的接口（只读）

接口	方法	用途
INLINECODE14	获取周期列表	选择工作周期
INLINECODE15

获取分组树 | 导航到目标分组 | | POST /bp/group/getPersonalGroupIds | 批量获取个人分组ID | 快速定位员工 | | GET /bp/task/v2/getSimpleTree | 获取BP任务树 | 了解完整结构 | | GET /bp/goal/list | 获取目标列表 | 查看目标概览 | | GET /bp/goal/{goalId}/detail | 获取目标详情 | 查看单个目标完整信息 | | GET /bp/keyResult/list | 获取关键成果列表 | | | GET /bp/keyResult/{keyResultId}/detail | 获取关键成果详情 | | | GET /bp/action/list | 获取关键举措列表 | | | GET /bp/action/{actionId}/detail | 获取关键举措详情 | | | GET /bp/group/markdown | 获取分组BP Markdown | AI 分析友好 | | POST /bp/group/batchGetKeyPositionMarkdown | 批量获取关键岗位详情 | | | GET /bp/task/children | 获取任务子树骨架 | | | POST /bp/task/relation/pageAllReports | 查询任务关联汇报 | 支持时间范围过滤 | | GET /bp/delayReport/list | 查询延期汇报历史 | | | GET /bp/task/v2/searchByName | 按名称搜索任务 | | | GET /bp/group/searchByName | 按名称搜索分组 | | | GET /bp/monthly/report/getByMonth | 按分组+月份查询月度汇报 | |

写入接口（归属 cms-bp-manager-write）

接口	方法	用途
INLINECODE32	新增关键成果	→ cms-bp-manager-write
INLINECODE33

新增关键举措 | → cms-bp-manager-write | | POST /bp/delayReport/send | 发送延期提醒汇报 | → cms-bp-manager-write |

---

数据模型

Period（周期）

CODEBLOCK5

Group（分组）

CODEBLOCK6

Goal（目标）

CODEBLOCK7

KeyResult（关键成果）

CODEBLOCK8

Action（关键举措）

CODEBLOCK9

TaskUser（任务参与人）

CODEBLOCK10

Employee（员工）

interface Employee {
  id: string;   // 员工 ID
  name: string; // 员工姓名
}

---

错误处理

错误码	说明	处理建议
1	请求成功	正常处理
0

通用失败 | 提示用户稍后重试 | | 610002 | appKey 无效 | 检查 BPAPPKEY 环境变量 | | 610015 | 无访问权限 | 提示用户无权限访问该资源 |

---

使用注意事项

1. 1. API 限制：当前系统不支持编辑和删除操作，只能通过 Web UI 进行
2. 权限控制：部分接口有数据权限校验，无权限时返回空列表
3. 周期管理：建议每次操作前先确认当前周期
4. 性能考虑：getGroupMarkdown 返回完整 BP，Token 消耗较大，适合 AI 分析场景
5. 鉴权依赖：所有接口调用统一依赖 cms-auth-skills，脚本不实现登录与换 token

---

审计输出要求（强制）

• - 结论必须精确引用到具体对象（编号+名称）
• 不允许使用"部分/某些/个别"等模糊指代
• 问题必须包含：对象精确引用 + 严重等级 + 原因 + 建议
• 审计维度覆盖：基础合规、向上对齐、向下承接、GAP 分析

---

能力树

CODEBLOCK12

---

版本历史

版本	日期	变更说明
v1.0.0	2026-04-04	初版，包含 BP 查看/管理/检查/提醒功能（原 bp-manager）
v2.0.0

2026-04-08 | 重构：基于原版 bp-manager 重建，写入能力拆分至 cms-bp-manager-write；新增月度汇报查询、时间范围过滤、UTF-8 兼容 |