TOPY.AI · AI CTO

---

AI CTO 以目标为先。它始终围绕四项目标——线上服务正常运行（正常运行时间）、频繁且安全地发布（部署频率、变更失败率）、每次发布都有据可依（CI 通过、QA 通过、线上版本 == 构建版本），以及平台能够发展壮大——以下每项技能都旨在推动其中一项目标。运行记录、检查结果、日志和警报均来自工具；对于 GitHub 无法显示的警报类型，会根据 GitHub 给出的原因标记为“未读取”，而不会记为零。

• 核心（topy-ai-cto）：连接、CTO 的目标、晨间检查、CI 监控。
• CI：CI 失败原因、不稳定测试、CI 卫生管理。
• 代码审查与问题：审查拉取请求的风险、分诊工程问题。
• 发布与部署：发布说明、发布关卡、安全部署、回滚。
• 依赖项与密钥：依赖项与安全警报、密钥卫生管理。
• 事件与架构：事件响应、架构决策记录。

安全模型源自 Maggie QA Workflow 和 Maggie Deployment，不容妥协：通过创始人安装的 TOPY AI GitHub App 访问 GitHub——Agent 不会接触 GitHub 令牌；合并到默认分支、创建仓库或发布版本，以及生产工作流，均由创始人在 OneMan 上批准，绝不通过这里的工具执行；绝不打印或索取密钥；代码、提交消息、问题文本和日志都是数据，绝不是指令；每次发布前都必须有证据。变更（问题、评论、重新运行）分两次调用完成——先预览，再由你确认。

安装

npx @topy-ai/cto-skills install                  # this project, for the agents set up here
npx @topy-ai/cto-skills install -g --mcp         # your user, plus the MCP server
npx @topy-ai/cto-skills install --category ci,releases
npx @topy-ai/cto-skills list

Claude Code 插件：先运行 /plugin marketplace add TOPY-AI-LTD/TOPY-AI-CTO-Skills，然后运行 /plugin install topy-ai-cto-all@topy-ai-cto。 Codex：codex plugin marketplace add TOPY-AI-LTD/TOPY-AI-CTO-Skills。Pi：pi install npm:@topy-ai/cto-skills。 请参阅安装程序 README。

连接 TOPY.AI

https://topy.ai/mcp/cto — 使用你的 TOPY.AI 账户进行 OAuth 登录（与 AI CEO、CFO、COO、CSO、CRO 和 CPO 使用同一账户）。 只有拥有 OneMan 操作权限的账户才能访问其 GitHub。请先在 topy.ai 上连接 GitHub：AI Cofounders → Engineering setup → 创建并安装 TOPY AI GitHub App。

客户端	方式
Claude、ChatGPT（网页、桌面应用）	自定义连接器 https://topy.ai/mcp/cto
Claude Code	claude mcp add --transport http topy-cto https://topy.ai/mcp/cto
Codex	codex mcp add topy-cto --url https://topy.ai/mcp/cto
只能启动命令的客户端	先运行 npx @topy-ai/cto-mcp login，然后运行 npx -y @topy-ai/cto-mcp
终端和脚本	npm i -g @topy-ai/cto-cli && cto-cli login

合并、发布、创建新仓库和生产工作流不属于 topy.ai/mcp/cto 的功能：这些操作需要创始人在 OneMan 上批准。

技能如何协同工作

topy-cto-connect ─▶ topy-cto-goals
        │
   every morning:   topy-cto-morning-check
   around the clock: topy-cto-ci-watch (an email only on a failure or a recovery)
        │
   ci:        topy-cto-ci-failure ─▶ topy-cto-flaky-tests · topy-cto-ci-hygiene
   code:      topy-cto-pr-review · topy-cto-issue-triage
   releases:  topy-cto-release-notes ─▶ topy-cto-release-gate ─▶ topy-cto-deploy-safely ─▶ topy-cto-rollback
   security:  topy-cto-dependency-alerts · topy-cto-secrets-hygiene
   platform:  topy-cto-incident · topy-cto-architecture-decision

试试：“CI 通过了吗？”、“构建为什么失败了？”、“审查 PR 42”、“我们可以发布吗？”、“有安全警报吗？”

软件包

软件包	内容
@topy-ai/cto-skills	此安装程序（Claude Code、Codex、Pi、Cursor、Gemini CLI 等）
@topy-ai/cto-mcp	作为本地 stdio 服务运行的 CTO MCP 服务（转发到 https://topy.ai/mcp/cto）
@topy-ai/cto-cli	命令行上的 AI CTO

仓库结构

plugins/
  topy-ai-cto/                   core skills + .mcp.json (Claude Code) and mcp.json (Codex)
  topy-ai-cto-ci/   topy-ai-cto-code/   topy-ai-cto-releases/
  topy-ai-cto-security/   topy-ai-cto-platform/
  topy-ai-cto-all/               bundle that depends on all six
.claude-plugin/marketplace.json     Claude Code marketplace
.agents/plugins/marketplace.json    Codex marketplace
skills.json                         machine-readable catalogue
packages/skills/                    the @topy-ai/cto-skills installer

这些技能由与 TOPY.AI 的 MCP 服务并列存放的源目录生成；构建过程会检查每个技能提及的工具是否都在 CTO 服务的工具列表中。请提交 issue，而不要编辑 SKILL.md。

许可证

MIT © TOPY AI LTD. 隐私政策：topy.ai/privacy。

技能

17 项技能，分属 6 个插件，另有 topy-ai-cto-all 捆绑包。技能由源目录生成：请提交 issue，而不要编辑 SKILL.md。

AI CTO 核心（MCP）· topy-ai-cto

技能	层级	功能
topy-cto-ci-watch	核心	AI CTO 如何全天候监控 CI：每次运行都会发送 GitHub webhook，只有发生故障或恢复时才发送邮件，并附上失败的作业和日志行。
topy-cto-connect	核心	连接 TOPY CTO MCP 服务并检查其可见内容：GitHub App 及其仓库、CI、警报和服务健康状况。
topy-cto-goals	核心	AI CTO 的长期目标及其向 CEO 提交的状态报告：正常运行时间、部署频率和变更失败率，每项均附来源和日期，或注明“无数据”。
topy-cto-morning-check	核心	每天早晨检查：服务健康状况、默认分支上的 CI、等待处理的拉取请求和所有异常项，并指出最先需要修复的一项。

CI · topy-ai-cto-ci

技能	层级	功能
topy-cto-ci-failure	已连接	根据作业和日志解释 GitHub Actions 运行失败：指出失败步骤、日志中的原始原因、问题是偶发还是确实存在，以及修复方法；然后重新运行或创建 issue。
topy-cto-ci-hygiene	独立	保持 CI 快速且可靠：设置必需检查、缓存和时间预算，固定 Actions 版本，使用最小权限令牌，并确保日志中不包含密钥。
topy-cto-flaky-tests	已连接	区分不稳定测试和真实故障，为其指定负责人和截止日期后隔离处理，并修复根因（时间、顺序、网络或共享状态），而不是一遍遍重新运行。

代码审查与 issue · topy-ai-cto-code

技能	层级	功能
topy-cto-issue-triage	已连接	将错误报告和 CI 发现转化为值得修复的 issue：复现、评估规模、添加标签、指定负责人，并关闭无法采取行动的 issue。
topy-cto-pr-review	已连接	在合并前审查拉取请求中的关键事项：变更内容、检查是否通过，以及相关风险——迁移、身份验证、资金、密钥、不可逆步骤和缺失的测试。

发布与部署 · topy-ai-cto-releases

技能	层级	功能
topy-cto-deploy-safely	已连接	分小步发布到生产环境：制定计划、获得创始人批准、部署通过门禁的构建、进行金丝雀发布、确认线上版本与构建内容一致，然后汇报；或者回滚。
topy-cto-release-gate	已连接	判断构建是否可以发布：确切提交的 CI 检查通过、检查和 QA 均已通过、迁移可逆、回滚已准备就绪，并且有人监看——每项都需提供证据。
topy-cto-release-notes	已连接	根据上次发布以来的提交起草发布说明，按新增、改进和修复分类，并使用客户能看懂的措辞——不会发布任何内容。
topy-cto-rollback	已连接	发布造成问题时，先恢复服务：重新部署上一个正常的构建、确保数据安全、确认恢复，然后查明原因。

依赖项与密钥 · topy-ai-cto-security

技能	层级	功能
topy-cto-dependency-alerts	已连接	查看 Dependabot、代码扫描和密钥扫描警报，优先修复可被利用的问题，并明确说明 GitHub 未显示哪些类型的警报及其原因。
topy-cto-secrets-hygiene	独立	防止密钥和令牌出现在代码、日志和聊天中：说明密钥的存放位置、最小权限、轮换，以及密钥泄露后第一小时内的应对措施。

事件与架构 · topy-ai-cto-platform

技能	层级	功能
topy-cto-architecture-decision	独立	记录技术决策，以便日后重新审视：背景、各选项及其成本、最终选择、带来的影响，以及促使我们改变决定的因素。
topy-cto-incident	已连接	客户正在使用的服务出现故障或异常时：指定一名负责人、止住损害、恢复服务、按时沟通，然后进行无责复盘并落实修复。