kodwai 是一个面向开发者的智能体编程（agentic coding）挑战平台。它让开发者在本机、用自己的编辑器、用自己的 AI 编程智能体（Claude Code、Cursor 或 Codex）解决真实编码挑战，并评分开发者指挥智能体的水平。
用途
kodwai 的核心用途是练习并评估“智能体编程”或“AI 原生编程”能力，即通过指挥 AI 智能体来构建软件，而不是逐行手写代码。它不测试记忆算法，而是给出 ticket 大小的项目任务，评分开发者如何引导 AI 智能体完成这些任务。官方将其定位为 LeetCode 的补充而非替代：LeetCode 用于经典算法面试准备，kodwai 用于练习部分公司采用的 AI 相关面试环节。
主要能力
评分围绕三个轴：Direction（指挥方式）、Outcome（最终成果）和 Lift（相对单独 AI 的提升）。Direction 权重最高，涵盖验证严谨性、意图保真度、边界情况覆盖等；Outcome 关注交付的测试与代码质量，或挑战自带的评分标准；Lift 衡量开发者捕捉隐藏陷阱以及比单独 AI 做得更好的程度。默认权重下三个轴各占一定比例，有自带评分标准的挑战则采用 45/45/10 的权重。
每次评分运行会列出最多 6 个影响分数的时刻，采用类似国际象棋复盘的方式，每个时刻附带证据；如果存在错误，其中至少 2 个错误会保留在列表中。
挑战库包含 15 个挑战：3 个简单、3 个中等、9 个困难，涵盖后端、前端、分布式系统、数据、AI、移动等方向。例如 Bookshelf REST API（后端，简单，60 分钟）、Searchable Product Listing UI（前端，简单，60 分钟）、Idempotent ETL Pipeline with Schema Drift（数据，中等，90 分钟）、Production RAG Service with Eval Harness & Cost Guardrails（AI，困难，120 分钟）、Multi-Currency Wallet Ledger with Idempotent Transfers（后端，困难，120 分钟）、Offline-First Notes App（移动，简单，60 分钟）。每个挑战隐藏若干容易忽略的需求陷阱。
使用方式
流程分三步：第一步，在终端挑选挑战并运行一条命令，CLI 会下载问题、起始文件和测试并启动计时器：npx @kodwai/cli@latest challenge <slug>；第二步，在自己的编辑器中按平时方式解决，规划、提示、测试并在智能体出错时纠正；CLI 会询问使用哪个智能体。第三步，在终端提交代码、提交记录、测试运行结果和智能体对话记录，获得满分 100 的分数：npx @kodwai/cli@latest submit。CLI 只从挑战文件夹收集内容。
评分与联赛
开发者拥有以 Direction Rating 为基础的 Elo 式评分，据此划分段位：Bronze（0 至 999）、Silver（1000 至 1149）、Gold（1150 至 1299）、Platinum（1300 至 1449）、Diamond（1450 至 1599）、Master（1600 至 1799）、Grandmaster（1800 及以上）。每周一 00:00 UTC 开启新联赛，首次评分运行会被分入最多 30 人的小组；积分取每个挑战的最佳分数并乘以难度系数（简单 1 倍、中等 1.5 倍、困难 2 倍），前 5 名升组，后 5 名降组。联赛每周重置，但评分和段位会保留。个人资料页位于 app.kodwai.com/developers/your-username，展示分数、段位、徽章和使用的智能体；每次评分运行还会生成分享卡片，包含总分、三个轴分数和最佳时刻。
团队用途
官方还面向招聘团队提供私有面试功能：可基于自己的问题运行面试，查看候选人使用 Claude Code 在其本机工作的完整过程，按自有标准进行 0 到 10 分评分，并获得每一步的完整对话记录。
限制与费用
kodwai 对开发者免费。前 3 次提交由平台密钥评分，之后需在设置中添加自己的 Anthropic API 密钥以获得无限次运行；密钥会被加密，仅用于评分。通过测试并不足以获得高分：没有规格说明、没有检查、没有纠正的单一提示即使测试全绿，Direction 得分也会很低。支持的智能体为 Claude Code、Cursor 和 Codex。平台不在浏览器沙盒中运行，而是在开发者本机进行。
