@blueking/bkui-knowledge 0.0.1-beta.14 → 0.0.1-beta.15

package/knowledge/skills/bk-monitor-tapd-summary/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: bk-monitor-tapd-summary
+description: 获取 TAPD 待办单据并生成归纳总结。当用户提到获取 TAPD 单据、查看待办时使用。
+---
+
+# TAPD 待办单据汇总器
+
+## 工作流程
+
+### Step 1: 获取待办
+
+对 workspace `10158081`（蓝鲸监控）和 `70093903`（蓝鲸开发工具）分别调用：
+
+- stories_get（需求）
+- bugs_get（缺陷）
+- tasks_get（任务）
+
+只获取未开发完成状态的单据。
+
+### Step 2: 数据处理
+
+1. 合并所有单据，标记类型和项目
+2. 按紧急程度分组（已逾期 > 本周内 > 本月内 > 远期）
+3. 组内按优先级排序
+4. 最多处理 60 条
+
+### Step 3: 生成链接
+
+详见 summary-template.md
+
+### Step 4: 输出汇总
+
+按 summary-template.md 模板输出。
+
+## 注意事项
+
+- 只展示未开发完成的单据
+- 去重：同一单据只显示一次
+- 缺陷无 due 字段时归类到「远期」
+
+---
+
+## 📦 可用资源
+
+- `skill://bk-monitor-tapd-summary/references/mcp-calls.md`
+- `skill://bk-monitor-tapd-summary/references/status-mapping.md`
+- `skill://bk-monitor-tapd-summary/references/summary-template.md`

package/knowledge/skills/bk-monitor-tapd-summary/references/mcp-calls.md

@@ -0,0 +1,86 @@
+# MCP 调用详情
+
+## 获取待办单据
+
+对每个 workspace 执行以下查询：
+
+### 获取需求（未开发完成）
+
+```
+Server: user-tapd_mcp_http
+Tool: proxy_execute_tool
+Arguments: {
+  "tool_name": "stories_get",
+  "tool_args": {
+    "workspace_id": "{workspace_id}",
+    "owner": "liangling",
+    "status": "planning|developing|status_7|status_11|status_12|status_5|status_6|status_13|status_14|status_4",
+    "with_v_status": "1",
+    "limit": 30,
+    "fields": "id,name,owner,due,priority,priority_label,status,v_status,workspace_id"
+  }
+}
+```
+
+### 获取缺陷（未开发完成）
+
+```
+Server: user-tapd_mcp_http
+Tool: proxy_execute_tool
+Arguments: {
+  "tool_name": "bugs_get",
+  "tool_args": {
+    "workspace_id": "{workspace_id}",
+    "current_owner": "liangling",
+    "status": "new|assigned|in_progress|reopened|unconfirmed|TM_audited",
+    "limit": 30,
+    "fields": "id,title,current_owner,due,priority,priority_label,status,workspace_id"
+  }
+}
+```
+
+### 获取任务（未开发完成）
+
+```
+Server: user-tapd_mcp_http
+Tool: proxy_execute_tool
+Arguments: {
+  "tool_name": "tasks_get",
+  "tool_args": {
+    "workspace_id": "{workspace_id}",
+    "owner": "liangling",
+    "status": "open|progressing",
+    "limit": 30,
+    "fields": "id,name,owner,due,priority,priority_label,status,workspace_id"
+  }
+}
+```
+
+## 目标 Workspace
+
+- `10158081`（蓝鲸监控）
+- `70093903`（蓝鲸开发工具）
+
+## 状态筛选说明
+
+只获取以下未开发完成状态的单据：
+
+| 类型 | 未开发完成状态                                                                                           | 说明                                                                                                    |
+| ---- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| 需求 | planning, developing, status_7, status_11, status_12, status_5, status_6, status_13, status_14, status_4 | backlog、todo、doing、designing、design approved、for approve、approved、for accept、accepted、重新打开 |
+| 缺陷 | new, assigned, in_progress, reopened, unconfirmed, TM_audited                                            | backlog、todo、doing、reopen、for accept、accepted                                                      |
+| 任务 | open, progressing                                                                                        | 未开始、进行中                                                                                          |
+
+**排除的状态（已开发完成）：**
+
+- 需求：status_1(已实现)、for_test(转测试)、testing、tested、for gray、done 等
+- 缺陷：resolved(for test)、acknowledged(testing)、closed(tested)、QA_audited(done) 等
+- 任务：done(已完成)
+
+## 数据预处理
+
+1. **合并所有单据**：将所有 workspace 的需求、缺陷、任务合并为统一列表
+2. **标记类型和项目**：每条记录标记类型（需求/缺陷/任务）和项目名
+3. **按紧急程度分组**：根据截止日期分组
+4. **组内按优先级排序**：每个分组内按优先级从高到低排序
+5. **数量限制**：最多处理前 60 条单据

package/knowledge/skills/bk-monitor-tapd-summary/references/status-mapping.md

@@ -0,0 +1,88 @@
+# TAPD 状态映射表
+
+记录各类单据的状态关键字与显示名称的对应关系。
+
+## 需求（Story）状态
+
+| 状态关键字 | 显示名称 | 是否已开发完成 |
+|-----------|----------|---------------|
+| `planning` | backlog(新) | ❌ |
+| `developing` | todo(接受待排期) | ❌ |
+| `status_7` | doing | ❌ |
+| `status_11` | designing | ❌ |
+| `status_12` | design approved | ❌ |
+| `status_5` | for approve(echo 审批) | ❌ |
+| `status_6` | approved | ❌ |
+| `status_13` | for accept | ❌ |
+| `status_14` | accepted | ❌ |
+| `status_4` | 重新打开 | ❌ |
+| `status_1` | 已实现 | ✅ |
+| `for_test` | for test(转测试) | ✅ |
+| `status_8` | testing | ✅ |
+| `status_9` | tested | ✅ |
+| `status_2` | for gray(发布运维环境) | ✅ |
+| `status_10` | grayed(已在运维环境验收) | ✅ |
+| `status_3` | done(发布上云环境) | ✅ |
+| `resolved` | 已关闭 | ✅ |
+| `rejected` | refuse(已拒绝) | ✅ |
+
+## 缺陷（Bug）状态
+
+| 状态关键字 | 显示名称 | 是否已开发完成 |
+|-----------|----------|---------------|
+| `new` | backlog | ❌ |
+| `assigned` | todo | ❌ |
+| `in_progress` | doing | ❌ |
+| `reopened` | reopen | ❌ |
+| `unconfirmed` | for accept | ❌ |
+| `TM_audited` | accepted | ❌ |
+| `resolved` | for test | ✅ |
+| `acknowledged` | testing | ✅ |
+| `closed` | tested | ✅ |
+| `PMM_audited` | for gray | ✅ |
+| `planning` | grayed | ✅ |
+| `QA_audited` | done | ✅ |
+| `rejected` | refuse | ✅ |
+| `verified` | closed | ✅ |
+
+## 任务（Task）状态
+
+| 状态关键字 | 显示名称 | 是否已开发完成 |
+|-----------|----------|---------------|
+| `open` | 未开始 | ❌ |
+| `progressing` | 进行中 | ❌ |
+| `done` | 已完成 | ✅ |
+
+## 未开发完成状态筛选
+
+### 需求未开发完成状态
+```
+planning|developing|status_7|status_11|status_12|status_5|status_6|status_13|status_14|status_4
+```
+
+对应中文：backlog(新)、todo(接受待排期)、doing、designing、design approved、for approve、approved、for accept、accepted、重新打开
+
+### 缺陷未开发完成状态
+```
+new|assigned|in_progress|reopened|unconfirmed|TM_audited
+```
+
+对应中文：backlog、todo、doing、reopen、for accept、accepted
+
+### 任务未开发完成状态
+```
+open|progressing
+```
+
+对应中文：未开始、进行中
+
+## 状态分类说明
+
+| 阶段 | 需求状态 | 缺陷状态 | 说明 |
+|-----|---------|---------|------|
+| 待开发 | planning, developing | new, assigned | 尚未开始开发 |
+| 开发中 | status_7 (doing), status_11, status_12 | in_progress | 正在开发 |
+| 待审批/验收 | status_5, status_6, status_13, status_14 | unconfirmed, TM_audited | 开发完成，待审批或验收 |
+| 已开发完成 | status_1, for_test, status_8, status_9 | resolved, acknowledged, closed | 开发完成，待测试/测试中 |
+| 已上线 | status_2, status_10, status_3 | PMM_audited, planning, QA_audited | 已发布到各环境 |
+| 已关闭 | resolved, rejected | rejected, verified | 需求关闭或拒绝 |

package/knowledge/skills/bk-monitor-tapd-summary/references/summary-template.md

@@ -0,0 +1,109 @@
+# 待办汇总模板
+
+## 输出格式
+
+```markdown
+# TAPD 待办汇总（按紧急程度）
+
+## 已逾期（共 X 条）
+
+### 需求（X 条）
+
+| 项目名    | 标题              | 处理人  | 状态     | 优先级     | 截止日期 |
+| --------- | ----------------- | ------- | -------- | ---------- | -------- |
+| {project} | [{title}]({link}) | {owner} | {status} | {priority} | {due}    |
+
+### 缺陷（X 条）
+
+| 项目名    | 标题              | 处理人  | 状态     | 优先级     | 截止日期 |
+| --------- | ----------------- | ------- | -------- | ---------- | -------- |
+| {project} | [{title}]({link}) | {owner} | {status} | {priority} | {due}    |
+
+### 任务（X 条）
+
+| 项目名    | 标题              | 处理人  | 状态     | 优先级     | 截止日期 |
+| --------- | ----------------- | ------- | -------- | ---------- | -------- |
+| {project} | [{title}]({link}) | {owner} | {status} | {priority} | {due}    |
+
+## 本周内到期（共 X 条）
+
+...
+
+## 本月内到期（共 X 条）
+
+...
+
+## 远期或无截止日期（共 X 条）
+
+...
+```
+
+**说明**：如果某个类型在该分组中没有数据，则不显示该类型的子标题和表格。
+
+## 字段说明
+
+| 占位符       | 说明          | 来源                                               |
+| ------------ | ------------- | -------------------------------------------------- |
+| `{project}`  | 项目名        | 根据 `workspace_id` 映射                           |
+| `{title}`    | 单据标题      | 需求用 `name`，缺陷用 `title`，任务用 `name`       |
+| `{link}`     | TAPD 详情链接 | 根据类型和 id 生成                                 |
+| `{owner}`    | 处理人        | 需求/任务用 `owner`，缺陷用 `current_owner`        |
+| `{status}`   | 状态          | 使用 `v_status` 中文名称                           |
+| `{priority}` | 优先级        | 使用 `priority_label`，无则显示「-」               |
+| `{due}`      | 截止日期      | `due` 字段，无则显示「-」                          |
+
+## 处理人格式化
+
+- 去除末尾分号：`liangling;` → `liangling`
+- 多人用逗号分隔：`liangling;edwinwu;` → `liangling, edwinwu`
+
+## 紧急程度分组规则
+
+| 分组             | 规则                          |
+| ---------------- | ----------------------------- |
+| 已逾期           | due < 今天                    |
+| 本周内到期       | 今天 <= due <= 今天+7 天      |
+| 本月内到期       | 今天+7 天 < due <= 今天+30 天 |
+| 远期或无截止日期 | due > 今天+30 天 或 due 为空  |
+
+## 排序规则
+
+每个紧急程度分组内，按优先级权重从小到大排序：
+
+| 原始值              | 显示文本 | 排序权重 |
+| ------------------- | -------- | -------- |
+| `urgent`            | 紧急     | 1        |
+| `High` / `high`     | 高       | 2        |
+| `Middle` / `medium` | 中       | 3        |
+| `Low` / `low`       | 低       | 4        |
+| 空 / 其他           | -        | 5        |
+
+## 状态中文映射
+
+| 状态关键字  | 中文显示        |
+| ----------- | --------------- |
+| planning    | backlog         |
+| developing  | todo            |
+| status_7    | doing           |
+| status_11   | designing       |
+| status_12   | design approved |
+| status_5    | for approve     |
+| status_6    | approved        |
+| status_13   | for accept      |
+| status_14   | accepted        |
+| status_4    | 重新打开        |
+| new         | backlog         |
+| assigned    | todo            |
+| in_progress | doing           |
+| reopened    | reopen          |
+| unconfirmed | for accept      |
+| TM_audited  | accepted        |
+| open        | 未开始          |
+| progressing | 进行中          |
+
+## 输出格式要求
+
+1. **使用 Markdown 表格**：标题列使用 `[标题](链接)` 格式
+2. **按紧急程度分组**：已逾期 > 本周内 > 本月内 > 远期或无截止日期
+3. **组内按优先级排序**：紧急 > 高 > 中 > 低 > 无
+4. **添加统计信息**：在末尾添加汇总统计

package/knowledge/skills/bk-monitor-weekly-report/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: bk-monitor-weekly-report
+description: 通过 GitHub MCP 获取用户 PR 并生成周报。当用户提到生成周报、写周报时使用。
+---
+
+# 周报生成器
+
+## 工作流程
+
+### Step 1: 获取用户信息
+
+调用 `toolbase_github_get_my_user`，记录 `login` 字段。
+
+### Step 2: 搜索 PR
+
+对以下仓库搜索用户最近 7 天的 PR：
+
+- TencentBlueKing/bk-monitor
+- TencentBlueKing/bk-monitor-grafana-plugins
+- TencentBlueKing/bkui-vue2
+- TencentBlueKing/bk-weweb
+- TencentBlueKing/bk-monitor-grafana
+
+调用 `toolbase_github_search_issues`。
+
+### Step 3: PR 分类
+
+- 需求：feat、feature、新增、添加
+- Issues：fix、bug、修复、优化
+- 其他：不匹配以上规则
+
+优先级：Labels > 标题关键词
+
+### Step 4: 生成周报
+
+按 weekly-template.md 输出。
+
+---
+
+## 📦 可用资源
+
+- `skill://bk-monitor-weekly-report/references/classification-rules.md`
+- `skill://bk-monitor-weekly-report/references/weekly-template.md`

package/knowledge/skills/bk-monitor-weekly-report/references/classification-rules.md

@@ -0,0 +1,138 @@
+# PR 分类规则详细说明
+
+## 快速参考表
+
+| 分类   | 标题关键词                                  | Labels               |
+| ------ | ------------------------------------------- | -------------------- |
+| 需求   | feat、feature、需求、新增、添加、支持       | feature、enhancement |
+| Issues | fix、bug、issue、修复、问题、优化、refactor | bug、fix、bugfix     |
+| 其他   | 不匹配以上规则的 PR                         | -                    |
+
+## 分类关键词表
+
+### 需求类（Features）
+
+**标题关键词（不区分大小写）：**
+- `feat`
+- `feature`
+- `需求`
+- `新增`
+- `添加`
+- `支持`
+- `实现`
+- `开发`
+- `新功能`
+
+**Labels：**
+- `feature`
+- `enhancement`
+- `new feature`
+- `需求`
+
+### Issues 类（Bug fixes & Improvements）
+
+**标题关键词（不区分大小写）：**
+- `fix`
+- `bug`
+- `issue`
+- `修复`
+- `问题`
+- `优化`
+- `refactor`
+- `重构`
+- `改进`
+- `perf`
+- `性能`
+
+**Labels：**
+- `bug`
+- `fix`
+- `bugfix`
+- `hotfix`
+- `issue`
+- `问题`
+
+### 其他类
+
+不匹配以上任何规则的 PR 归类到「其他」。
+
+常见的其他类型：
+- `docs` - 文档更新
+- `chore` - 杂项任务
+- `style` - 代码风格
+- `test` - 测试相关
+- `ci` - CI/CD 相关
+- `build` - 构建相关
+
+## 分类优先级
+
+1. **Labels 优先**：如果 PR 有 labels，优先根据 labels 分类
+2. **标题次之**：如果没有 labels 或 labels 无法匹配，则根据标题关键词分类
+3. **默认其他**：都无法匹配时，归类到「其他」
+
+## 标题解析规则
+
+### Conventional Commits 格式
+
+```
+<type>(<scope>): <subject>
+```
+
+解析示例：
+- `feat(trace): 添加追踪功能` → type=feat, scope=trace, subject=添加追踪功能
+- `fix: 修复时区问题` → type=fix, subject=修复时区问题
+
+### 中文标题格式
+
+```
+【模块名】功能描述
+```
+
+解析示例：
+- `【AI小鲸】小鲸组件化-基础组件开发` → module=AI小鲸, subject=小鲸组件化-基础组件开发
+
+## 状态映射表
+
+| GitHub PR 状态 | merged 值 | 周报状态 |
+|---------------|----------|---------|
+| Open | false | 开发中 |
+| Closed (merged) | true | 开发完成 |
+| Closed (not merged) | false | 开发中 |
+
+## 仓库配置
+
+```javascript
+const repositories = [
+  { owner: 'TencentBlueKing', repo: 'bk-monitor' },
+  { owner: 'TencentBlueKing', repo: 'bk-monitor-grafana-plugins' },
+  { owner: 'TencentBlueKing', repo: 'bkui-vue2' },
+  { owner: 'TencentBlueKing', repo: 'bk-weweb' },
+  { owner: 'TencentBlueKing', repo: 'bk-monitor-grafana' }
+];
+```
+
+## MCP 搜索参数
+
+### 获取用户信息
+
+```
+Server: user-Toolbase
+Tool: toolbase_github_get_my_user
+```
+
+记录返回的 `login` 字段。
+
+### 搜索 PR
+
+```
+Server: user-Toolbase
+Tool: toolbase_github_search_issues
+Arguments: {
+  "q": "type:pr author:{用户名} repo:{仓库} created:>={7天前日期}",
+  "sort": "created",
+  "order": "desc",
+  "per_page": 100
+}
+```
+
+**日期格式**：`YYYY-MM-DD`，例如 `created:>=2024-01-20`

package/knowledge/skills/bk-monitor-weekly-report/references/weekly-template.md

@@ -0,0 +1,100 @@
+# 周报模板
+
+## 输出格式
+
+```markdown
+# 上周进展
+
+## 需求
+
+- 【{PR 标题}】({状态})
+- 【{PR 标题}】({状态})
+
+## Issues
+
+- 【{PR 标题}】({状态})
+
+## 其他
+
+- 【{PR 标题}】({状态})
+```
+
+**格式说明**：
+
+- 每个 PR 前添加 `*` 符号
+- PR 标题用【】包裹
+- 状态用（）包裹，值为「开发完成」或「开发中」
+- 如果某个分类没有 PR，则不显示该分类
+- 同一个 PR 标题可能包含多个关键词，只归类到第一个匹配的分类
+
+## 完整示例
+
+**输入 PR 数据：**
+
+```json
+[
+  { "title": "feat: 【AI小鲸】小鲸组件化-基础组件开发", "merged": true, "labels": ["feature"] },
+  { "title": "fix: 【子路径+时区】子路径+时区测试体验", "merged": false, "labels": ["bug"] }
+]
+```
+
+**输出周报：**
+
+```markdown
+# 上周进展
+
+## 需求
+
+- 【AI 小鲸】小鲸组件化-基础组件开发（开发完成）
+
+## Issues
+
+- 【子路径+时区】子路径+时区测试体验（开发中）
+```
+
+## 输出格式要求（重要）
+
+生成周报后，必须按以下方式输出，方便用户直接复制：
+
+1. **先输出一个纯文本代码块**，使用 ```text 包裹，用户可以直接复制
+2. 代码块内不要有任何额外说明文字
+3. 在代码块之后，可以补充 PR 统计信息
+
+**输出示例：**
+
+````
+以下是你的周报，可直接复制：
+
+```text
+# 上周进展
+
+## 需求
+* 【AI小鲸】小鲸组件化-基础组件开发（开发完成）
+
+## Issues
+* 【子路径+时区】子路径+时区测试体验（开发中）
+```
+
+---
+**统计信息：** 共 2 个 PR，需求 1 个，Issues 1 个
+````
+
+## 标题清洗规则
+
+1. 移除前缀类型标识：`feat:`, `fix:`, `chore:`, `docs:`, `refactor:`, `style:`, `test:` 等
+2. 移除前缀空格
+3. 如果标题已有【】包裹内容，直接使用【】内的内容
+4. 如果标题没有【】，则整体用【】包裹
+
+**示例**：
+
+- `feat: 【AI小鲸】组件开发` → `【AI小鲸】组件开发`
+- `fix: 修复时区问题` → `【修复时区问题】`
+- `feat(trace): 添加追踪功能` → `【添加追踪功能】`
+
+## 状态判断
+
+| PR 状态        | 周报状态 |
+| -------------- | -------- |
+| merged = true  | 开发完成 |
+| merged = false | 开发中   |

package/knowledge/skills/chat-x-ccontribute/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: chat-x-contribute
+description: 帮助开发者上手 @blueking/chat-x 组件库开发。当用户需要了解 chat-x、开发新组件时使用。
+---
+
+# Chat-X 组件库开发指南
+
+## 项目概述
+
+`@blueking/chat-x` 是蓝鲸 AI Chat 组件库。
+
+**技术栈**：Vue 3 + TypeScript + bkui-vue + Vite
+
+**核心特性**：流式渲染、Markdown、代码高亮、LaTeX、Mermaid
+
+## 开发环境
+
+```bash
+pnpm install                           # 安装依赖
+pnpm --filter @blueking/chat-x dev     # 启动开发
+pnpm --filter @blueking/chat-x build   # 构建
+```
+
+## 项目结构
+
+```
+packages/chat-x/src/
+├── components/    # 组件
+├── composables/   # 组合式函数
+├── types/         # 类型定义
+└── index.ts       # 入口
+```
+
+## 开发新组件
+
+1. 创建文件：`src/components/new-component/`
+2. 导出组件：`src/components/index.ts`
+3. 添加类型：`src/types/`
+4. 编写文档：`wikis/components/`
+
+## 最佳实践
+
+- 使用 `<script setup>` 语法
+- Props 使用 TypeScript 接口
+- 文件名使用 kebab-case
+- HTML 内容使用 DOMPurify 过滤
+
+---
+
+## 📦 可用资源
+
+- `skill://chat-x-contribute/references/component-api.md`
+- `skill://chat-x-contribute/references/development-workflow.md`
+- `skill://chat-x-contribute/references/QA.md`
+- `skill://chat-x-contribute/references/style-guide.md`
+- `skill://chat-x-contribute/references/type-definitions.md`