BlueRoseNote/07-Other/AI/AI Agent/WY/MCP&Skill/POPO 云文档MCP&Skill.md

# 简介
**MATRIX-AITA POPO 云文档操作 Skill** 是公司内部首个公开的云文档编辑Skill。它彻底解决了以往 AI Agent “只能看、不能写”的痛点，通过强大的自动化能力，让 AI 助手真正拥有了替你处理文档、整理表格、甚至管理多维数据的“双手”，是提升团队办公效率的硬核神器。

## 功能介绍
- 📄 **文档（深度创作与排版）** 你可以指挥 AI 从零开始撰写项目建议书或会议纪要，它不仅能生成文字，还精通排版逻辑。它支持自动插入 1 到 5 级标题、符号列表以及有序列表，让文档结构层次分明。除了创建新文档，你还可以让它在现有文档末尾追加灵感，或者随时远程重命名文档，让文档管理变得动动嘴就能搞定。
- 📊 **表格（智能数据录入）** 繁琐的数据录入和报表更新现在可以全权交给 AI 处理，它能精准地在指定的单元格中填入内容。你可以要求它为关键数据标记背景色以示提醒，或者批量修改某一区域的字体格式，快速生成美观的进度表。即便面对海量数据，它也能通过“精准定位”修改特定数值，再也不用在大表中拉动滚动条寻找目标了。
- 📝 **Markdown（专业技术文档生成）** 这是为开发者和技术同学准备的排版利器，AI 可以为你生成包含代码块、数学公式以及 Mermaid 流程图的高质量内容。它支持标准的 Markdown 语法，能够完美处理复杂的引用、分割线和链接，确保技术文档既专业又易读。无论是编写 README 还是整理技术方案，它都能确保输出的内容格式工整、开箱即用。
- **🗄️ 多维表格（自动化数据中心）** 你可以把复杂的任务追踪、资产管理或人员名单交给 AI 来打理，它支持多维表格的各项核心操作。无论是新增一条任务记录，还是修改某个单选、日期字段的状态，AI 都能像数据库管理员一样精准执行。它还能帮你快速查询表内的现有记录，并根据逻辑自动汇总信息，让你的多维表格真正变成一个能自我更新的智能系统。
- **👥 团队空间（无缝跨部门协作）** 该 Skill 突破了个人文档的限制，能够直接在公司各级“团队空间”中大显身手。它能自动识别团队的目录结构，在指定的页面或文件夹下创建子文档，并自动处理复杂的协作权限验证。这意味着你可以授权 AI 自动更新团队周报、维护公共知识库，让所有团队成员都能实时共享到 AI 辅助生成的最新成果。

---

## 操作步骤介绍
### 1. 安装Skill
进入 https://skills.netease.com/skills/skill_b67793104fac
复制安装命令给Agent或者下载该Skill，最后让Agent帮你安装。
### 2. 自动化授权（获取 Cookie）
无需手动查代码，直接运行我们提供的脚本即可（也可让Agent帮忙运行）：
- **双击运行**：在 `tools` 目录中找到 `collect-cookies_GBK.bat` 并双击。
- **告知 Agent**：登录完成后，回到对话窗口对 Agent 说 **“我登录了”**，它将自动完成后续的 Token 采集与保存。    

### 3. 开始使用
授权完成后，你就可以尝试给 Agent 下达类似下方的指令了：
- _“把这个表格里 A1 到 D1 的背景色改成黄色。”_
- _“读取多维表格‘项目进展’中所有状态为‘进行中’的记录。”_

## 备注
该Skill现阶段仍处于开发阶段，如果遇到问题请加入 群号：7271072，@楼嘉杰来解决。


---

Gitlab Token：uunSQeYYhBCAn2a5C55H
ANTHROPIC_API_KEY
CI/CD Trigger 8b84579d3405f7a16f86ac2f2bcb59

---



以下是修改后的 `.gitlab-ci.yml` 示例以及关键配置步骤：
### 1. 准备工作（CI/CD 变量设置）
在 GitLab 项目的 **Settings -> CI/CD -> Variables** 中，请确保已配置以下变量：
- **`ANTHROPIC_API_KEY`**: 你的内部接口授权 Token。
- **`GITLAB_TOKEN`**: 具有 API 写入权限的 Personal Access Token（用于回帖）。
- **`ANTHROPIC_BASE_URL`**: 设置为 `https://openai.nie.netease.com/v1`（注意添加 `/v1` 后缀）。

### 2. 修改后的 `.gitlab-ci.yml` 脚本
这个脚本会在 Issue 触发时运行，使用 Claude Code 尝试修复，并利用 GitLab API 将结果反馈到 Issue 讨论区。
```yml
claude_main_fix:
  stage: ai_fix
  image: node:20
  variables:
    GIT_STRATEGY: clone
    GIT_DEPTH: 0
  script:
    - npm install -g @anthropic-ai/claude-code
    - export ANTHROPIC_BASE_URL="https://openai.nie.netease.com/v1"
    
    # 1. 配置 Git 机器人身份（必须，否则无法 commit）
    - git config --global user.email "claude-bot@yourcompany.com"
    - git config --global user.name "Claude AI Bot"
    
    # 2. 切换到主分支并确保是最新状态
    # 注意：$CI_DEFAULT_BRANCH 通常是 main 或 master
    - git checkout $CI_DEFAULT_BRANCH
    - git pull origin $CI_DEFAULT_BRANCH

    # 3. 运行 Claude Code 进行直接修复
    # 删除了“创建新分支”的指令，明确要求“直接修改”
    - |
      claude --yes "你现在处于项目根目录的主分支。请分析项目结构，直接修复 Issue #$ISSUE_IID。
      Issue 描述：$ISSUE_DESCRIPTION
      修复完成后，请直接保存文件，不要创建新分支。"
    
    # 4. 提交并推送回主分支
    # 使用包含 Token 的 URL 进行推送，确保有权限
    - |
      git add .
      if git commit -m "fix(auto): 自动修复 Issue #$ISSUE_IID [skip ci]"; then
        git push "https://project_${CI_PROJECT_ID}_bot:${GITLAB_TOKEN}@${CI_SERVER_HOST}/${CI_PROJECT_PATH}.git" HEAD:$CI_DEFAULT_BRANCH
        echo "代码已直接推送到主分支。"
      else
        echo "没有发现需要修复的更改或提交失败。"
      fi
  allow_failure: true
```

### 3. 核心改进说明
- **接口重定向**：通过 `export ANTHROPIC_BASE_URL` 强制 CLI 访问网易内部代理接口。
- **非交互式处理**：在 CI 环境中，Claude Code 会尝试直接执行指令。建议在指令中明确要求它“创建新分支”而非直接推送到主分支，以保证代码安全。
- **自动回帖流**：
    - 脚本捕获了 Claude Code 的输出并存入 `repair_summary.txt`。
    - 使用 `curl` 调用 GitLab 的 `/notes` API。`$CI_API_V4_URL` 和 `$CI_PROJECT_ID` 是 GitLab CI 内置的变量，无需手动配置。
- **上下文读取**：为了让修复更准确，你可以在指令中加入 `Check CLAUDE.md for project guidelines`，确保 AI 遵循你在项目中定义的规范。