𝓚𝓪𝓽𝓪

让需求、用例、自动化与证据，构成一条可复核的 QA 工程流水线。

English · 安装指南 · 配置说明

面向 𝑪𝒍𝒂𝒖𝒅𝒆 𝑪𝒐𝒅𝒆 与 𝑶𝒑𝒆𝒏𝑨𝑰 𝑪𝒐𝒅𝒆𝒙 的 QA 工程工作区：需求分析、测试用例、Bug 分析、Playwright 自动化、服务器调试与知识沉淀，均以可复用的 Skill 与 CLI 交付；产物统一落盘，运行全程可复核。

目录

• 工作流
• 能力地图
• 快速开始
• 项目结构
• 开发与验证

工作流

flowchart LR
    A["需求 / 设计稿"] --> B["需求拆解"] --> C["用例与知识"]
    D["已有用例 / 缺陷"] --> E["标准化与分诊"] --> F["可执行的修复建议"]
    G["用例 / 失败结果"] --> H["Playwright 自动化"] --> I["运行记录、截图与报告"]
    J["服务器 / 数据源"] --> K["受控诊断"] --> L["脱敏的连通性结论"]

Loading

Kata 的价值不在生成更多文本，而在于每个结果都能回溯到输入、命令与证据：

• Skill 正文以 .claude/skills/ 为唯一来源，.agents/skills/ 仅为 Codex 提供软链。
• 通用 CLI 位于 cli/，Claude Code 与 Codex 共用同一套实现。
• 项目输入、用例、自动化与运行产物统一落入 workspace/{project}/。
• 平台 Cookie、插件凭据、基础设施凭据与数据源信息仅保存在本机 Git 忽略的配置中，绝不进入版本库。

能力地图

入口	适合的问题	主要产物
/test-case	从 PRD、设计稿等需求来源编写、编辑和同步用例	YAML / XMind / 可追溯的 SourceRef
/ui-automation	把既有 feature 用例变成真实 Playwright 自动化	spec、run 目录、Allure 与截图
/defect-analyze	分析堆栈、HTTP 失败、冲突或代码差异	根因、影响面与修复建议
/infra-diagnose	检查服务器或数据源的 SSH2 连通性	脱敏 Markdown 诊断报告
/domain-knowledge	查询或维护项目业务规则和术语	可复用的领域知识
/workspace-management	创建、修复和检查 Kata 工作区	标准化的工作区骨架

快速开始

一键安装

将以下提示词发送给任意本地 AI 编程助手（Claude Code、Codex 等）：

请完成 https://github.com/koco-co/kata.git 的安装与首次配置引导：
1. git clone https://github.com/koco-co/kata.git && cd kata
2. 读取仓库根目录的 INSTALL.md，严格按文档完成环境安装与配置引导：
   检查并安装前置依赖，执行 bun install/link/ci，引导用户获取各平台配置
   （如 ZenTao Cookie、平台 URL、凭据）并写入 config/private/ 下对应文件；
3. 全程不得将任何凭据或密钥写入聊天记录或提交；
4. 基础配置完成后，在 workspace/ 下初始化一个项目，并走完一次
   test-case skill 流程（推荐）；
5. 其余 skill 流程由用户决定是否继续；若不继续，结束本次本地引导任务。

项目结构

kata/
├── .claude/skills/       # Skill 正文唯一来源
├── .agents/skills/       # Codex 侧 symlink
├── .codex-plugin/        # Codex 插件清单
├── cli/                  # kata CLI 与集成实现
├── config/               # example 模板与本机私密配置边界
├── runtime/              # 可复用的数据库、Playwright 与 runner 支撑
├── tests/                # CLI、集成与 Skill 测试
└── workspace/            # 项目输入、用例、run 与报告

开发与验证

bun install --frozen-lockfile
bun run check
bun run type-check
bun test --timeout 30000 ./tests ./cli/lib
bun run test:automation-lint
bun run ci

License

MIT