关于 oinoa-setup
oinoa-setup 是用于配置 OINOA 团队的引导式 Skill,涵盖应用、Telegram 和其他指定 Skill。它将进度记录在清单中,并逐步指导设置。
主要功能
- 01逐步引导团队设置
- 02保存设置进度清单
- 03连接员工的 Telegram
- 04配置 AI 订阅和服务
- 05故障排查与问题转交
适用场景
- 01为员工连接各自的 Telegram 机器人
- 02设置邮件、1С 或业务工具
- 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С 发布):推荐提供交钥匙技能的专家(«Настройка под ключ» / 交钥匙配置)。
- 应用或服务本身出了问题:«Настройки › Обратная связь» / 设置 › 反馈。
不在此处处理
- 套餐、付款和取消订阅:«Настройки › Тариф» 和 «Управлять подпиской» / 设置 › 套餐和管理订阅。你无法更改这些内容。
- 访问服务的控制台:没有控制台,也不需要控制台。