docs: split English and Chinese READMEs

Author: Howe829

README-CN.md

@@ -0,0 +1,115 @@
+# Team First Development
+
+[![CI](https://github.com/Howe829/team-first-development/actions/workflows/ci.yml/badge.svg)](https://github.com/Howe829/team-first-development/actions/workflows/ci.yml)
+
+[English README](README.md)
+
+Team First Development（TFD）是一个 Codex Skill：在开始实现之前，先组建面向具体任务的开发团队，再通过明确授权、渐进式交付门禁、候选版本绑定评审和基于证据的收尾机制协调团队。
+
+TFD 会搜索本地 [Agency Agents](https://github.com/msitarzewski/agency-agents) 角色文件和可选的私有自定义角色。它将角色提示视为专业工作方法，而不是项目事实、编排运行时或第二套控制平面。
+
+## 为什么需要 TFD
+
+多 Agent 协作经常以相似的方式失败：团队规模过大、角色流于形式、授权含糊、评审者检查的候选版本不一致、陈旧构建被误判为通过，或者把自动化证据误当作真人验收。
+
+TFD 为交付过程增加了一套小而严格的契约：
+
+- 动态选择“最小充分团队”，不固定成员数量；
+- 开始执行前先建立授权边界和团队章程；
+- 委派必须指名、限定范围、设置有效期且不可转授；
+- 设置契约门禁、代表性垂直切片门禁和冻结候选门禁；
+- 使用一份候选清单绑定源码、依赖、构建产物、运行环境和验证证据；
+- 评审状态统一为 `PASS`、`BLOCKER` 和 `UNVERIFIED`；
+- 自动化、团队评审、真人/真机、用户验收和部署状态分别记账；
+- 阻塞后只允许一次有边界的修复循环，随后重新冻结、重新评审并执行回归验证。
+
+## 仓库结构
+
+```text
+SKILL.md                         TFD 操作契约
+agents/openai.yaml              Codex 界面元数据与默认提示词
+scripts/agent_catalog.py        只读的本地角色目录
+scripts/test_agent_catalog.py   角色目录回归测试
+scripts/test_skill_contract.py  TFD 契约回归测试
+references/custom-agent-format.md
+```
+
+## 环境要求
+
+- 支持本地 Skills 的 Codex
+- Python 3.10 或更高版本
+- 位于 `~/.agency-agents` 的本地 Agency Agents 仓库
+- 可选的私有自定义角色目录 `~/.agency-agents-custom`
+
+在正常使用和测试期间，角色目录工具不会写入上游 Agency Agents 仓库。
+
+## 安装
+
+如果本地尚未安装 Agency Agents，请先克隆：
+
+```bash
+git clone https://github.com/msitarzewski/agency-agents.git ~/.agency-agents
+```
+
+将本仓库克隆到 Codex Skills 目录：
+
+```bash
+git clone https://github.com/Howe829/team-first-development.git ~/.codex/skills/team-first-development
+```
+
+如果 Codex 没有自动发现该 Skill，请重启或重新加载 Codex。
+
+## 使用方法
+
+在 Codex 请求中显式调用该 Skill：
+
+```text
+使用 $team-first-development 为这个任务组建最小充分团队。
+```
+
+TFD 会先确认事实和授权范围，搜索角色能力，提出团队名单与章程，并等待批准；只有当用户已经提供完整、指名且有边界的委派时才会跳过等待。批准后，仅加载已选中的角色。
+
+### 角色目录示例
+
+```bash
+python3 scripts/agent_catalog.py validate
+python3 scripts/agent_catalog.py search "accessibility performance"
+python3 scripts/agent_catalog.py inspect upstream:engineering/engineering-frontend-developer
+python3 scripts/agent_catalog.py load upstream:engineering/engineering-frontend-developer
+```
+
+如需覆盖默认来源，请在子命令前使用 `--upstream-dir` 或 `--custom-dir`。
+
+自定义角色文件使用受限的标量 frontmatter 格式，详情参见 [references/custom-agent-format.md](references/custom-agent-format.md)。
+
+## 验证
+
+测试套件可以独立运行，并且不会修改 Agency Agents 仓库：
+
+```bash
+python3 -m unittest scripts/test_skill_contract.py scripts/test_agent_catalog.py
+```
+
+如需针对真实本地角色目录执行冒烟测试：
+
+```bash
+python3 scripts/agent_catalog.py validate
+```
+
+如果可选的自定义角色目录不存在，验证会报告该情况；只要上游来源有效，验证仍可成功。
+
+## 安全模型
+
+- 角色提示是工作方法，不是权威项目事实。
+- 系统和开发者指令、用户请求、仓库规则、当前启用的 Skills、安全规则及经过验证的证据始终具有更高优先级。
+- 团队名单批准不等于授权部署、发布、删除、特权命令、外部消息或其他范围扩张。
+- 真人、真机、无障碍、听觉和用户验收在指定验收者真正执行并记录之前均保持 `UNVERIFIED`。
+- 保留工作区中的未知改动，不使用破坏性的 Git 清理来消除不确定性。
+
+## 许可证
+
+[MIT](LICENSE)
+
+## 致谢
+
+TFD 集成了 [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) 提供的本地角色库。该项目由其维护者独立维护，并继续作为专业角色方法的来源。

README.md

@@ -2,6 +2,8 @@
 
 [![CI](https://github.com/Howe829/team-first-development/actions/workflows/ci.yml/badge.svg)](https://github.com/Howe829/team-first-development/actions/workflows/ci.yml)
 
+[中文简介](README-CN.md)
+
 Team First Development (TFD) is a Codex Skill for forming a task-specific development team before implementation, then coordinating that team through explicit authority, progressive delivery gates, candidate-bound review, and evidence-based closeout.
 
 TFD searches local [Agency Agents](https://github.com/msitarzewski/agency-agents) role files and optional private custom roles. It treats those role prompts as specialist methods—not as project facts, an orchestration runtime, or a second control plane.
@@ -111,11 +113,3 @@ An absent optional custom-role directory is reported as an issue while validatio
 ## Acknowledgements
 
 TFD integrates with the local role library from [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents), which is maintained separately and remains the source of specialist role methods.
-
----
-
-## 中文简介
-
-Team First Development 是一个 Codex Skill：先依据任务动态选择“最小充分团队”，再通过授权边界、团队章程、渐进式门禁、冻结候选和证据账本协调开发交付。
-
-它不会固定团队人数，也不会把 Agency Agents 角色提示当成项目事实或新的运行时。自动化、团队评审、真人/真机、用户验收和部署状态分别记账；未执行的验收保持 `UNVERIFIED`。