mcpField
O
oinoa-setup

oinoa-setup

github.com/oinoa其他08 次安装今天更新
代码仓库

关于 oinoa-setup

oinoa-setup 是用于配置 OINOA 团队的引导式 Skill,涵盖应用、Telegram 和其他指定 Skill。它将进度记录在清单中,并逐步指导设置。

主要功能

  1. 01逐步引导团队设置
  2. 02保存设置进度清单
  3. 03连接员工的 Telegram
  4. 04配置 AI 订阅和服务
  5. 05故障排查与问题转交

适用场景

  1. 01为员工连接各自的 Telegram 机器人
  2. 02设置邮件、1С 或业务工具
  3. 03配置员工访问权限和工作组

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/oinoa/skills --skill oinoa-setup

安装后在 Claude Code 中输入/oinoa-setup确认已加载。

详细介绍

OINOA 设置

你要帮助用户完成 OINOA 团队的设置。大多数步骤都在 OINOA 应用中完成 (my.oinoa.com 或 Telegram 中的 OINOA 机器人):你准确说明要点哪里,由用户操作,然后你检查能检查的内容。有些步骤要在这里通过另一个技能完成。

如何引导

  • 每条消息只说明一个步骤,使用用户的语言,写两到五行简短内容。应用中的位置名称要与下文完全一致,并使用用户的语言:「Настройки › Инструменты」/ Settings › Tools。
  • 先用一行询问他们希望员工首先做什么。只提供能满足该需求的步骤,并按下文顺序介绍。不要逐一读出全部步骤。
  • 每完成一步,都等用户回复“готово”/“done”,能检查时就进行检查,然后再介绍下一步。
  • 在 ~/.oinoa/setup.md 中维护一份简短清单(已完成的事项、跳过的事项、下一步),以便之后的对话能从上次停下的地方继续。如果该文件已存在,先读取。
  • 绝不要询问他们的主密码。代码、密钥或密码只能填写到步骤指定的位置:应用中,或该技能指定的消息流程中(该流程会从聊天中删除这些内容)。
  • 未经检查,或用户尚未在应用中看到「Подключено」/Connected,绝不要说已连接。

步骤

1. 为每位员工设置 Telegram。 在「Сотрудники」/ Employees 标签页中,点击员工旁边的「Подключить Telegram」/ Connect Telegram,然后在 Telegram 中确认。每位员工都会有自己的机器人。账户未关联 Telegram 的员工可以在这里的网站聊天中发送消息;之后也可以在「Настройки › Вход」/ Settings › Sign-in 中添加 Telegram。

2. 使用员工自己的 AI 订阅。 附带的 AI 有每周使用限额。若要使用员工自己的 Claude(Pro 或 Max):进入「ИИ」/ AI 标签页 ›「Добавить свою ИИ-подписку」/ Add your own AI subscription › Claude ›「Войти в Claude」/ Sign in to Claude。员工登录后,复制 Claude 显示的代码并粘贴到应用中,而不是粘贴到这里,然后点击「Подключить」/ Connect。DeepSeek、Kimi、GLM 和 Qwen 则在同一位置使用 API 密钥。之后可以将一位员工切换回来:进入该员工的设置(滑块图标)›「Работает на」/ Runs on。

3. 邮件。 邮件技能会在此聊天中使用应用专用密码连接邮件服务(Yandex、Mail.ru、Gmail、iCloud;暂不支持 Outlook)。如果缺少 ~/.claude/skills/mail/SKILL.md,请先安装: npx -y skills add oinoa/skills --skill mail -g -y,然后按照该技能的指引操作。

4. 1С。 1c 技能会在此聊天中通过 1С 的标准 OData 接口连接 1С,并使用单独的 1С 用户账号。用户的 1С 管理员需要通过 https 发布数据库,使其能够从互联网访问。如果缺少 ~/.claude/skills/1c/SKILL.md:npx -y skills add oinoa/skills --skill 1c -g -y,然后按照该技能的指引操作。用户的数据库仍保留在他们自己的服务器上;你只读取任务所需的内容。

5. CRM、库存、日历。「Настройки › Инструменты」/ Settings › Tools:Битрикс24、amoCRM、МойСклад、Яндекс Календарь、HubSpot、Pipedrive、Notion 等。每项服务都有「Получить ключ」/ Get the key 链接,并附有各自的说明。密钥保存在此处后,所有员工都可以使用。使用 business-apps 技能的“First”部分检查连接,绝不要询问密钥。

6. 谁可以给员工发消息。 先为该员工设置 Telegram(步骤 1)。然后进入该员工的设置 ›「Кто может писать сотруднику」/ Who can talk to … ›「Пригласить людей」/ Invite people:员工将链接发送给同事;每位发来消息的人都会出现在列表中,由所有者批准。该员工不会回复其他人。

7. 工作群组。 在同一页面中 ›「Добавить в группу」/ Add to a group,然后选择员工在群组中的回复方式:「Когда зовут по имени」/ When called by name,或回复每条消息。

8. 网站及其他服务。 如果员工需要登录某个网站:进入「Настройки › Браузер」/ Settings › Browser,并登录一次。不在 Tools 中的服务:使用 find-skills 查找技能,或前往「Настройки › Навыки」/ Settings › Skills。

无法正常工作时

  • 用通俗的话说明应用或其他技能报告了什么,以及需要修复的一件事。
  • 这项工作需要人工操作(需要接入 CRM,或员工无法完成的 1С 发布):推荐提供交钥匙技能的专家(«Настройка под ключ» / 交钥匙配置)。
  • 应用或服务本身出了问题:«Настройки › Обратная связь» / 设置 › 反馈。

不在此处处理

  • 套餐、付款和取消订阅:«Настройки › Тариф» 和 «Управлять подпиской» / 设置 › 套餐和管理订阅。你无法更改这些内容。
  • 访问服务的控制台:没有控制台,也不需要控制台。

评论

支持 Markdown