aictrl

aictrl.dev 工程技能与插件

一套精简、厂商中立的 AI 工程工作流技能，集中于一个规范目录中。你可以只安装技能，也可以安装 aictrl.dev 插件，以获得相同的技能以及通过 OAuth 连接的受控工作流执行功能。

aictrl MCP 服务

托管的 aictrl MCP 服务可让编码 Agent 访问项目上下文、待办任务、代码审查发现以及受控工作流执行功能。使用 Streamable HTTP 连接到 https://aictrl.dev/mcp，并通过 OAuth 登录。无需 API 密钥或本地服务进程。

你需要一个 aictrl 账户 并加入某个 aictrl 组织。基于仓库的工作还需要通过 aictrl GitHub App 连接 GitHub 仓库。访问权限遵循你的组织成员身份；工作流执行则遵循已发布工作流的权限和审批关卡。

VS Code 中的 GitHub Copilot：

1. 打开命令面板并运行 MCP: Add Server。
2. 选择 HTTP (HTTP or Server-Sent Events)，然后输入 https://aictrl.dev/mcp。将服务命名为 aictrl，并选择配置目标。
3. 通过 VS Code 的 MCP 控件启动服务，并在出现提示时完成浏览器登录。

有关配置目标和服务控件，请参阅 VS Code 的 MCP 设置指南。

在其他 MCP 客户端中，添加相同的远程 URL，并在出现提示时完成 OAuth 登录。下方的 Claude Code 和 Codex 插件已包含 MCP 配置。连接检查和故障排除请参阅 SETUP.md。

连接后，可以尝试以下提示词：

• “检查我的 aictrl 账户是否已就绪。”
• “我可以使用哪些 aictrl 组织？”
• “显示我所在组织的待办任务。”
• “列出我可以运行的已发布工作流。”

此公开仓库包含托管服务的技能、客户端配置和注册表元数据。托管服务的源代码为私有。

安装

仅安装技能 — Codex、Claude Code、OpenCode 及兼容的 Agent

npx skills add aictrl-dev/skills

Claude Code 插件

/plugin marketplace add aictrl-dev/skills
/plugin install aictrl@aictrl-public

Codex 插件

codex plugin marketplace add aictrl-dev/skills --ref main
codex plugin add aictrl@aictrl-public

OpenCode — 使用 npx skills add aictrl-dev/skills 安装技能，然后将已连接的工作流服务添加到 opencode.json 并登录：

{ "mcp": { "aictrl": { "type": "remote", "url": "https://aictrl.dev/mcp", "enabled": true } } }

opencode mcp auth aictrl

Cursor / 直接安装 OpenCode 技能 — 技能采用跨工具的 Agent Skills 标准：

git clone https://github.com/aictrl-dev/skills && cd skills
./scripts/install.sh cursor       # or: opencode | all

……或者将 skills/* 复制到工具的技能目录中（~/.cursor/skills、~/.config/opencode/skills）。

然后自然地提出任务，或调用受支持的斜杠命令，例如 /create-issue、/implement-code-change、/code-review、/create-workflow， 或 /execute-workflow。

这些技能

技能	功能	试用
create-issue	模糊的功能需求或杂项任务 → 基于代码的 Issue，包含范围、验收标准、测试、风险和待解决问题。	/create-issue
create-bug	症状或回归问题 → 可复现、有证据支撑的 Bug，以及回归测试要求。	/create-bug
spec-review	Issue/规格说明 → 基于代码库的就绪度结论和具体的差距修复建议。	/spec-review
implement-code-change	Issue → 经过测试和审查、可在本地或通过可选的已连接工作流合并的 PR。	/implement-code-change
create-pr	确切的修订版本 + 证据 → 简洁、便于审查者查看的 PR 标题和正文，如实说明发布和验证情况。	/create-pr
code-review	确切的 PR head → 可执行的正确性、安全性、可靠性和测试问题；不修改代码。	/code-review
judge-review-findings	当前 head 的审查发现 → TRUE/FALSE/UNCERTAIN，以及 FIX/DEFER/IGNORE 判断。	/judge-review-findings
reply-to-code-review	已接受的审查发现 → 修复、验证、有证据支撑的回复，以及范围明确的再次审查。	/reply-to-code-review
root-cause-analysis	事故或反复出现的故障 → 基于证据的因果分析、同类问题影响范围图和预防方案集。	/root-cause-analysis
create-workflow	工作流意图 → 经过验证的 aictrl.dev workflow v2 YAML，包含可移植的内联任务节点。	/create-workflow
execute-workflow	已发布的工作流 → 经明确授权、幂等地启动，并安全监控、设置关卡、取消任务和持久化交接。	/execute-workflow
design-review	提供 HTML 模型或截图，即可获得针对 IA、价值主张、层级、信任度/操作阻力和无障碍设计的精准评析，并以「优先修复这 3 项」结尾。	/design-review path/to/mock.html
measurement-plan	功能 → 结构化的衡量计划：学习目标、指标表、产品分析事件、数据仓库变更和事件管道。	/measurement-plan
recording-product-demo	提供带有 Web UI 的代码库，即可启动应用、准备演示数据/身份验证，并录制带旁白、时间锁定且与 ElevenLabs 配音同步的 Playwright 演示视频，还会生成发布套件（MP4 + 字幕 + 嵌入内容）。	/recording-product-demo
explain-change	PR、提交范围或设计文档 → 以事实为依据的技术说明，阐释设计、艰难取舍和实际发布状态。	/explain-change
ui-polish	指定一个界面，即可渲染手机端和桌面端，测量截图中看不到的细节（列对齐、字段宽度、标签、点击目标、对比度、无效空间），修复源代码并重复测量，直至通过检查。	/ui-polish
ux-testing	指定页面或原型及若干任务后，AI 测试人员会通过无障碍树或截图，以首次使用者的身份进行测试；成功与否会根据页面状态验证（而非测试人员的说法），随后进行设计评审和修复循环，并重新测试，生成前后对比评分卡。还可选择模拟用户来评估布局假设。	/ux-testing path/to/page.html

design-review 实战示例

输入：SaaS 落地页模型。

Value Proposition — WEAK
  Hero headline "Workflows made simple" says nothing about what the product does.
  Fix: replace with a one-liner that names the user, the problem, and the outcome.

Actionability — BROKEN
  Three competing CTAs above the fold (Start free, Book demo, Watch video).
  Fix: one primary CTA above the fold; demote the others below.

每条评析都指出具体元素。每项修复都切实可行。不会泛泛地说「提升清晰度」。

ux-testing 实战

在一个内部工作队列设计中，新手 Agent 测试者被要求开始最重要的就绪工作，却批准了安全审查（v5：2 人中 2 人）。修复后，将就绪工作移到审批项上方，3 人中 3 人都开始了正确的问题。模拟用户也重现了同样的陷阱（72% 点击了「批准」），而针对页面状态的检查发现，一名测试者在什么都没创建后却报告成功。案例介绍： 积压事项设计的 AI 可用性测试。

为什么会有这些工具

这些技能免费且独立。aictrl.dev 提供受控远程执行、审批、策略、历史记录、集成和成本限制。implement-code-change 可以使用可选的已连接工作流，而 execute-workflow 可以安全地操作现有已发布工作流；除仅支持连接模式的 execute-workflow 外，所有启动技能都可使用本地模式。

Claude 和 Codex 插件以及 skills.sh 安装包都直接使用根目录下的 skills/。无需重新固定版本或手动编辑特定厂商的副本。连接模式执行始终使用 https://aictrl.dev/mcp 上的 aictrl MCP 身份；仅在使用连接工作流时才会请求 OAuth。

隐私、条款与支持

这些技能在本地运行，不会向 aictrl.dev 发送任何内容。捆绑的 aictrl MCP 服务仅在你通过 OAuth 连接时使用；其收集和保留的数据详见隐私政策和 条款。支持：aictrl.dev/support 或 [email protected]。安全问题报告： security.txt。MCP 连接的设置指南见 SETUP.md。

可选的第三方服务和密钥

两个技能可以向第三方服务发送数据，但仅限下方列出的步骤，且只有在你运行这些步骤时才会发送。安装时不会运行任何内容。密钥仅在对应步骤中读取，只会发送给表格中列出的服务，绝不会打印、记录或存储。每个密钥只属于它所发送到的服务：ElevenLabs 密钥只发送给 ElevenLabs，Google 凭据只发送给 Google，TypeSafe 密钥只发送给 TypeSafe，自定义模拟器密钥只发送到与其一起设置的端点。捆绑的 aictrl MCP 服务不会接收其中任何密钥。

其他技能都不会向第三方服务发送数据；基于浏览器的技能（ui-polish、ux-testing）只会加载你提供的应用 URL。

技能	步骤	服务及发送的数据	读取的环境变量
recording-product-demo	配音（tts-oneshot.cjs, split-narration.py）	ElevenLabs（api.elevenlabs.io）：旁白脚本，以及为语音转文字计时而生成的音频	ELEVENLABS_API_KEY（或由 ELEVENLABS_ENV_FILE 指定的文件）；可选的 ELEVENLABS_VOICE_ID、ELEVENLABS_MODEL、ELEVENLABS_STT_LANG
recording-product-demo	上传到 YouTube（使用 publish.upload.type youtube 运行 publish.cjs --upload，需主动选择）	Google（oauth2.googleapis.com、www.googleapis.com）：渲染后的 MP4、标题和说明，上传到你自己的频道	YT_CLIENT_ID、YT_CLIENT_SECRET、YT_REFRESH_TOKEN
recording-product-demo	上传到存储桶（使用 publish.upload.type gcs 或 s3 运行 publish.cjs --upload，需主动选择）	Google Cloud Storage 或 Amazon S3，通过你自己的 gcloud storage cp 或 aws s3 cp：将整套发布素材（MP4 文件、海报、字幕、嵌入页面、PUBLISH.md）上传到你配置的存储桶路径	无：CLI 使用其自身的已登录凭据
ux-testing	模拟用户（可选；Agent 测试人员无需密钥）	TypeSafe（api.typesafe.ai），或你设置的端点：每个模拟步骤的页面状态和候选操作	TYPESAFE_API_KEY（可选的 UX_SIM_MODEL 可覆盖默认模型），或 UX_SIM_ENDPOINT + UX_SIM_API_KEY + UX_SIM_MODEL

没有这些变量时，技能仍可运行：recording-product-demo 会在配音或上传步骤前停止，并说明缺少哪个密钥；ux-testing 则只使用 Agent 测试人员继续运行。UX_VERIFY_TOKEN 是 ux-testing 脚本与其自身本地服务之间的本地令牌，绝不会发送到本机之外。

贡献

欢迎提交新增技能的 PR——请参阅 CONTRIBUTING.md。 发布负责人也应遵循公开插件发布操作手册。