AI与人文·技能实践

从 GitHub 双重认证到 WorkBuddy 技能实践

从 GitHub 双重认证、Aegis 安装与迁移核查，到在 WorkBuddy 中查找、安装和验证技能的实践记录。

2026年10月27日

文树叶

最近登录 GitHub 时，我被一个英文页面拦住了：Enable two-factor authentication。以前用 Apple 账号就能登录，这次怎么还要验证？国家列表里找不到 China，又该怎么办？

我一步步询问、尝试，终于完成了双重认证（2FA），也成功登录。随后又遇到一个小插曲：刚用上的验证器只免费试用三天。于是，我找到了免费开源（Free and Open Source）的 Aegis，下载安装包（Package），传到华为手机，完成安装。

我也正在筹备一次 WorkBuddy 与技能（Skill）沙龙。这次从登录到安装的经历，恰好可以作为起点：GitHub 上有什么资源，Skill 能做什么，怎样把它装进 WorkBuddy，再用一个具体任务检验效果？

01 Apple 登录之后为什么还要认证

2FA 是 Two-Factor Authentication，中文通常叫双因素认证（Two-Factor Authentication，2FA），也常说双重认证。可以把它理解为：登录账号后，还要用自己持有的手机验证器，提供一道动态验证码（One-Time Password，OTP）。

Apple 登录与 GitHub 的额外认证属于不同环节。我的这次登录流程要求先启用 2FA，并不意味着 Apple 登录失效，也不能由此推断所有账号每次都会出现同样页面。

短信列表没有 China 时，可选择下方的 Authenticator app。

02 没有中国短信选项就用验证器

截图上的 Country or region code 是短信送达支持的地区列表。找不到 China 时，不必选一个其他国家再填中国手机号。我改点页面下方 Authenticator app 右侧的 Select，进入验证器设置。

这里需要的是支持 TOTP 的身份验证器（Authenticator）。TOTP 即基于时间的一次性验证码：绑定账号后，应用会定时生成新的6位数字。它不要求必须使用微软产品。

打开验证器，选择“添加账户”或“＋”，再选择“扫描二维码（QR Code）”，用手机对准电脑网页上的二维码。不是用微信或支付宝的普通扫一扫。

扫描不成功也有办法：点击二维码下方蓝色 setup key，GitHub 就会显示设置密钥（Setup Key）。在验证器选择“手动输入”，账户名填 GitHub，密钥填网页给出的字符串；如需选择类型，就选“基于时间”或 TOTP。

设置密钥用来绑定账户，手机生成的6位验证码用来验证身份。不要把这两项混为一谈，也不要公开二维码和设置密钥。

03 六位数字之后还有恢复码

手机出现验证码后，我把它填入 Verify the code from the app，再点 Continue。如果数字快过期，可以等待下一组生成后输入。验证通过，页面进入第二步：Download your recovery codes。

向下滚动，点击 Download，确认文件已保存，再点击页面上的继续按钮。恢复码（Recovery Codes）是手机丢失或验证器无法使用时的备用登录凭据，应该另存到安全的位置，不能只放在同一部手机里。

第三步出现绿色成功提示：Two-factor authentication (2FA) is now enabled for your GitHub account。这说明设置已经完成。

中间的 Passkeys、Security keys 和 GitHub Mobile 是其他备用认证方式，可以稍后配置。我点了底部绿色 Return to your work，随后已能登录 GitHub。

04 验证器不必为三天试用买单

我用华为手机，没有找到前面提到的微软验证器，就在应用商店找到了一款名字相近的第三方验证器。它确实生成了验证码，帮助我完成了前面的设置；但后来发现，免费试用只有三天。

“能生成验证码”和“适合长期使用”是两件需要分别确认的事。GitHub 不要求购买付费验证器，名称里写着 Authenticator，也不代表它就是微软或 Google 的官方产品。

我后来选择 Aegis Authenticator。官方项目将其介绍为免费、开源的 Android 双重认证应用。它没有我刚遇到的三天试用门槛，可以生成 GitHub 所需的动态验证码。

05 我怎样在华为手机上安装 Aegis

这一次，我没有继续在商店里按相似名称寻找，而是访问 Aegis 官方 GitHub 项目的版本发布页面。

我使用的版本页面 https://github.com/beemdevelopment/Aegis/releases/tag/v3.4.3

第一步：在电脑浏览器打开上述地址，找到 Assets（发布文件）区域，下载 aegis-v3.4.3.apk。APK 是 Android 应用安装包，不要误选 Source code。

第二步：把下载好的 APK 文件发送到自己的华为手机。

第三步：在手机找到并打开文件，按系统提示完成安装。如果系统询问是否允许当前应用安装文件，确认文件来自上述官方项目后再按需允许。

第四步：打开 Aegis。到这里，我已完成安装，目前看到的是免费使用。

这是我这次实际走通的安装路径。v3.4.3 是我使用的版本，不代表读者阅读时仍是最新版本。其他华为手机是否能安装，要看其系统是否兼容 Android APK，不能把我这一部手机的成功推广到所有型号。

06 安装完成还要确认账户已迁移

这里需要特别分清进度：我已成功登录 GitHub，也已安装 Aegis。但安装新应用本身，并不会把旧验证器里的 GitHub 账户自动搬过去。更换验证器需要重新绑定或迁移。

按 GitHub 官方说明，可在头像菜单进入 Settings → Password and authentication，找到 Two-factor methods 中的 Authenticator app，选择 Edit。用 Aegis 扫描新二维码，或手动输入新的 setup key，再把 Aegis 生成的6位数字填回 GitHub，点击 Save。

一定等新验证码通过验证并保存成功，再处理旧验证器。无需先关闭整个双重认证。仅仅安装成功，还不能作为迁移完成的依据。

07 GitHub 是什么为什么要认识它

GitHub 是基于 Git 的项目托管与协作平台（Hosting and Collaboration Platform）。Git 是记录文件变化的版本控制系统（Version Control System）；GitHub 则把项目放到网上，便于分享、讨论和持续更新。

对准备参加沙龙的朋友来说，可以先把仓库（Repository，简称 Repo）理解为一个有说明书、有更新记录的项目文件夹。里面可能是软件，也可能是资料、模板或供 AI 使用的技能。

以 yang0/handraw-style 为例，yang0 是发布者，handraw-style 是仓库名。先核对发布者与项目，再决定是否下载，比只搜索一个相似名称更可靠。

进入仓库先看这几个位置

项目说明（README）：看它解决什么问题、如何安装和使用。许可证（License）：看允许怎样使用和改编。版本发布（Releases）：下载作者发布的安装包。问题反馈（Issues）：查看已知问题或反馈故障。收藏（Star）：方便以后找回项目，不等于安全认证。

我安装 Aegis 时使用 Releases，下载的是 APK；安装 Skill 时，需要找到技能入口文件 SKILL.md 以及它依赖的脚本（Scripts）、参考资料（References）和素材（Assets）。这两类下载内容不同，不能把 APK 的安装方法照搬给 Skill。

公开仓库（Public Repository）的浏览和下载通常不要求先登录。我的账号这次登录需要完成 2FA，并不表示下载每个公开 Skill 都必须登录。私有仓库（Private Repository）或账号授权则可能需要身份验证。

Skill 是给 AI 使用的一套任务说明与资源，可包含工作流（Workflow）和工具调用方法。它能帮助 AI 按特定流程完成任务，但实际效果仍取决于模型、可用工具和运行环境。

GitHub 官方入门 https://docs.github.com/en/get-started/start-your-journey/what-is-github

08 从手绘风格 Skill 开始一次练习

我刚在 WorkBuddy 中尝试安装 yang0/handraw-style。对话返回“已完成本地安装”，并报告了366种视觉风格、170种排版图型和36种主题色。下面保留这次安装反馈。

WorkBuddy 本次安装反馈截图。数量为界面返回结果，并非本文重新逐项统计。

仓库会持续更新，不同语言说明也可能更新不同步。“278种”是我最初提出的查找描述，不能作为当前固定数量。理解用途，比记住数量更有帮助。

这个项目主要帮助生成双语图像提示词（Bilingual Image Prompts），把主题转成风格（Style）、排版（Layout）和配色（Color Palette）的具体要求。是否能直接出图，还取决于 WorkBuddy 当时可用的图像生成工具。

作者 yang0 的原始仓库 https://github.com/yang0/handraw-style

09 先从五项常见技能入手

我会优先围绕沙龙里的真实任务介绍以下技能。这是按常见办公需求选择的入门清单，不是安装量排名，也不表示我已经逐一在本机完成实测。WorkBuddy 官方也将办公文档四件套列入推荐。

Word 文档技能 docx

用于生成和修改可编辑文档（Editable Documents）。沙龙练习可以是：“把这些讨论整理成两页活动简报，保留事实来源，输出 DOCX。”检查姓名、时间和排版是否正确。

来源目录 https://github.com/anthropics/skills/tree/main/skills/docx

演示文稿技能 pptx

用于制作或修改幻灯片（Slides）。练习：“把简报转成6页分享稿，每页只讲一个要点，输出可编辑 PPTX。”检查文字是否拥挤、图表是否可读。

来源目录 https://github.com/anthropics/skills/tree/main/skills/pptx

电子表格技能 xlsx

用于数据清洗（Data Cleaning）、公式（Formulas）和汇总。练习：“把这份模拟报名表按参与意向汇总，用公式统计人数，输出 XLSX。”检查总数和公式。

来源目录 https://github.com/anthropics/skills/tree/main/skills/xlsx

PDF 处理技能 pdf

用于文本提取（Text Extraction）、拆分、合并及扫描件文字识别（Optical Character Recognition，OCR）。练习：“从这份 PDF 提取活动信息，并标出页码。”扫描件识别需要额外工具。

来源目录 https://github.com/anthropics/skills/tree/main/skills/pdf

技能查找 Find Skills

不知道选什么时，可在 WorkBuddy 技能市场搜索 find-skills，先描述任务，让它比较候选项。安装前核对发布者和用途。文档四件套在原仓库有各自许可证（License），不能把整个仓库都视为同一种开源授权；技能可获取也不代表模型调用、积分或外部服务免费。

10 怎样装到 WorkBuddy 并确认能用

第一条路使用技能市场

打开左侧“专家·技能·连接器”，选择“技能”，搜索 docx、pptx、xlsx、pdf 或 find-skills。核对来源后点击卡片的“＋”，再到“已安装”确认启用。不同版本的界面位置可能略有变化。

可复制的查找指令（Prompt）：“请在技能市场查找适合整理 Word 文档的 Skill，列出来源与用途，并检查是否已有同类技能；让我选择后再安装。”官方文档说明，这种市场对话安装只覆盖市场技能。

第二条路从 GitHub 仓库获取技能

我这次的手绘风格项目采用了对话委托。可参考：“请检查 https://github.com/yang0/handraw-style 的 README、许可证和 SKILL.md，找到适合 WorkBuddy 的技能入口，检查依赖（Dependencies）和已有同名技能，再安装并告诉我验证结果。”这是一条任务指令，不保证每个版本都能一键执行。

若直接导入未成功，可先让 WorkBuddy 从官方仓库整理本地技能包：保留目标技能目录内的 SKILL.md、脚本和引用素材，不要只复制一个说明文件，也不要把整仓库 ZIP 当成一定可导入的技能包。随后通过“添加技能 → 上传技能”导入界面支持的包，按提示检查结构与依赖。

文档四件套的来源是 anthropics/skills 仓库下 skills/docx、skills/pptx、skills/xlsx、skills/pdf 四个目录。若市场或本机已有对应技能，先试用现有版本；需要使用仓库版本时，再明确目标子目录与许可证，避免重复安装整个仓库。

第三步用小任务验证（Validation）

到“已安装”确认技能开启，新开一次对话，明确说“使用刚安装的 handraw-style，为这次沙龙给出两种封面方向，先只输出中英双语提示词”。检查是否真正调用目标技能、输出是否符合要求；安装成功提示本身不能证明任务已完成。

首次练习用模拟材料。若缺少运行环境、图像工具或外部服务，先解决依赖，再扩大任务。GitHub 登录凭据、恢复码和密钥不应作为安装材料发给技能。

WorkBuddy 官方技能安装说明 https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market

11 沙龙可以围绕一个成果展开

我准备开展的 WorkBuddy 与 Skill 沙龙，可以围绕同一份材料完成练习：从一段活动介绍出发，用 docx 整理简报，用 pptx 形成分享稿，再用 handraw-style 设计封面提示词。参与者不必一次装齐所有技能，每人选择一个自己最常用的场景即可。

这是一套可用于现场的练习建议，尚不是已经发生的活动记录。验收重点是打开真实产物，检查事实、格式与可编辑性，并比较普通对话和使用技能后的差异。

留下一个下次能用的办法

回看这次过程，最让我困惑的并不是某个复杂技术，而是几个看起来很接近的东西：Apple 登录和双重认证，设置密钥和动态验证码，免费试用和免费使用，以及安装完成和账户迁移完成。

把它们逐一分清，页面上的英文就能对应到具体行动：Select 是选择验证方式，setup key 是查看绑定密钥，Recovery codes 是保存备用恢复码，Return to your work 是回去继续操作。

对普通使用者来说，遇到验证页面，不妨先弄清当前在验证什么，再决定下一步点哪里。找到官方来源、保存好恢复码、确认新验证器确实能用，这些小步骤，能让下次登录从容一些。

本文安装经历截至2026年10月25日。文中二维码已遮盖；恢复码、设置密钥和有效验证码均不应作为公开配图。

主要词语与术语中英对照

GitHub：项目托管与协作平台；Git：版本控制工具；Repository / Repo：仓库；Public / Private Repository：公开／私有仓库。

README：项目说明；Releases：版本发布；Assets：发布附件或素材，按所在页面理解；License：许可证；Issues：问题反馈；Star：收藏。

Skill / Agent Skill：技能／智能体技能；SKILL.md：技能入口说明文件；Workflow：工作流；Prompt：提示词或任务指令；Dependencies：依赖；Scripts：脚本；References：参考资料。

2FA / Two-Factor Authentication：双因素认证；Authenticator：身份验证器；TOTP / Time-Based One-Time Password：基于时间的一次性验证码；QR Code：二维码；Setup Key：设置密钥；Recovery Codes：恢复码；Passkey：通行密钥。

APK / Android Package：安卓安装包；DOCX：Word 文档；PPTX：PowerPoint 演示文稿；XLSX：Excel 工作簿；PDF / Portable Document Format：便携式文档格式；OCR：光学字符识别。

主要术语在首次出现时标注英文；后文沿用中文或常见缩写，便于连贯阅读与查找界面。