diff --git a/.DS_Store b/.DS_Store index da1654a..b60853b 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/AGENTS.md b/AGENTS.md index 2f19245..eac7757 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,7 +5,7 @@ A collection of custom skills for the Huawei Cloud CodeArts Agent coding assistant. Skills are consumed at runtime by the CodeArts plugin — there is no build, test, or lint pipeline at the repo level. Skills fall into two categories: - **Installer skill** — `skill-installer` is the single meta-installer that bootstraps third-party frameworks/MCP servers into a CodeArts project/user scope. It consolidates four targets behind one entry point: `superpowers`, `office-mcp`, `playwright-cli`, `openspec` (each an adapter module under `scripts/targets/`). -- **Evaluation skills** — score and compare code-agent implementations (`codearena-cn`, `codearena-en`). +- **Evaluation skills** — score and compare code-agent implementations (`code-arena-cn`, `code-arena-en`). Per-skill usage, commands, and installation instructions live in `README.md`. This file describes repo-level conventions and contributor process only. @@ -43,8 +43,8 @@ CodeArtsSkills/ ├── LICENSE # MIT ├── skills/ # All skill sources (self-contained) │ ├── skill-installer/ # Single meta-installer (targets: superpowers, office-mcp, playwright-cli, openspec) -│ ├── codearena-cn/ -│ └── codearena-en/ +│ ├── code-arena-cn/ +│ └── code-arena-en/ └── .codeartsdoer/ # CodeArts runtime config (gitignored; do not restructure) ├── rule/metadata.properties ├── skills/ProjectSkillStatus.txt @@ -57,7 +57,7 @@ CodeArtsSkills/ ## 5. Development Workflow - **Branch per change** — create a feature branch, open a PR to merge. -- **codearena-cn / codearena-en are localized mirrors** — they share file layout but differ in localized text (UI selectors, button regexes, all `references/*.md`, `SKILL.md`). Mirror *structural/mechanic* changes across both; never overwrite localized text. +- **code-arena-cn / code-arena-en are localized mirrors** — they share file layout but differ in localized text (UI selectors, button regexes, all `references/*.md`, `SKILL.md`). Mirror *structural/mechanic* changes across both; never overwrite localized text. - **Manually test installer targets on all three platforms** (Windows, Linux, macOS) before merge. - **Update `README.md`** for any user-facing change (new skill, new target, new command, changed flags). - **Keep skills self-contained** — do not introduce imports between skills. @@ -105,7 +105,7 @@ node skills/skill-installer/scripts/test/run.js --filter openspec For targets that expose a `status` command (e.g., `office-mcp`, `openspec`), verify `node installer.js status --target ` exits `0` after `init` and reports incomplete after `delete`. -The `codearena` `scripts/templates/` are per-round harness skeletons generated at evaluation runtime — they are not standalone tests. +The `code-arena` `scripts/templates/` are per-round harness skeletons generated at evaluation runtime — they are not standalone tests. ## 9. Build & Commands @@ -141,7 +141,7 @@ A skill change is complete when: - [ ] SKILL.md frontmatter is valid (`name` + `description`). - [ ] `README.md` is updated for any user-facing change. - [ ] Each installer target in `README.md` lists its source GitHub URL and a brief install example (CLI command + natural language). -- [ ] codearena-cn/en pair kept in structural parity (localized text preserved). +- [ ] code-arena-cn/en pair kept in structural parity (localized text preserved). - [ ] Verified via the end-to-end install path (`npx skills add` → init/update/delete). ## 11. Safety Rules @@ -156,7 +156,7 @@ A skill change is complete when: - **Add a new skill**: create `skills//` with `SKILL.md` (+ `scripts/`, `references/`, `assets/` as needed); add a section to `README.md`. To add a new installable target, add an adapter to `skills/skill-installer/scripts/targets/.js`, register it in `targets/index.js`, and implement `init`/`update`/`delete`/`status`. - **Update a target**: edit the adapter at `skills/skill-installer/scripts/targets/.js` (and shared `lib/`); test `init`/`update`/`delete`/`status --target ` on all platforms; keep manifest logic in sync. -- **Update codearena**: make the structural change in both `codearena-cn` and `codearena-en`; keep localized text distinct. +- **Update code-arena**: make the structural change in both `code-arena-cn` and `code-arena-en`; keep localized text distinct. - **Document a skill**: edit `README.md`, not `AGENTS.md` (AGENTS.md is repo conventions only). ## 13. Decision Principles @@ -169,7 +169,7 @@ A skill change is complete when: ## 14. FAQ / Pitfalls -- **"codearena-cn and codearena-en are identical"** — No. They share file layout but differ in 8 files (localized UI selectors, button regexes, `tools-README.md`, all `references/*.md`, `SKILL.md`). Mirror structural changes only, never localized text. +- **"code-arena-cn and code-arena-en are identical"** — No. They share file layout but differ in 8 files (localized UI selectors, button regexes, `tools-README.md`, all `references/*.md`, `SKILL.md`). Mirror structural changes only, never localized text. - **`office-mcp` target is project-scope only** — `init --target office-mcp --user` is rejected by capability gating; there is no `--user` fallback. - **Shell scripts won't run on Windows** — `.sh` files need Git Bash or WSL. Prefer Node.js for cross-platform installer logic. - **`mcp_settings.json` contains absolute paths** — machine-specific; never copy between machines. The installer regenerates it. diff --git a/README.md b/README.md index 3f5b5ea..c5f3b3b 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,7 @@ node skills/skill-installer/scripts/test/run.js --all # + office-mcp, playw --- -### codearena-cn +### code-arena-cn 评测/对比基于同一需求的多个Agent代码实现并打分。按两套独立 rubric（通用 Basic /100 + 本轮需求 Round /100，各加最高 +10 动态加分）评测，产出中英双语报告，覆盖 API / 视觉 / SAST / 架构 / 治理 / 覆盖率评测。 @@ -97,7 +97,7 @@ node skills/skill-installer/scripts/test/run.js --all # + office-mcp, playw **Installation:** ```bash -npx skills add https://github.com/codeartsagent/codeartsskills --skill codearena-cn +npx skills add https://github.com/codeartsagent/codeartsskills --skill code-arena-cn ``` **Usage — 在 CodeArts 中输入以下指令即可触发：** @@ -114,7 +114,7 @@ Skill 会自动检测评测所需工具是否已安装，如缺失会自动安 --- -### codearena-en +### code-arena-en Evaluate, score, and compare multiple implementations of the same requirement — different builds of multi code agents. Uses two independent rubrics (Basic /100 + Round /100, each up to +10 dynamic bonus), produces bilingual (EN + CN) reports, covering API / visual / SAST / architecture / governance / coverage checks. @@ -125,7 +125,7 @@ Please put multi projects in the same workspace and open with one code agent too **Installation:** ```bash -npx skills add https://github.com/codeartsagent/codeartsskills --skill codearena-en +npx skills add https://github.com/codeartsagent/codeartsskills --skill code-arena-en ``` **Usage — trigger in CodeArts with:** diff --git a/skills/.DS_Store b/skills/.DS_Store index 1d96e35..dc0f548 100644 Binary files a/skills/.DS_Store and b/skills/.DS_Store differ diff --git a/skills/codearena-cn/SKILL.md b/skills/code-arena-cn/SKILL.md similarity index 99% rename from skills/codearena-cn/SKILL.md rename to skills/code-arena-cn/SKILL.md index 69eb723..96692ee 100644 --- a/skills/codearena-cn/SKILL.md +++ b/skills/code-arena-cn/SKILL.md @@ -1,5 +1,5 @@ --- -name: codearena-cn +name: code-arena-cn description: "评测/对比同一需求(或同一代码仓多个分支)的多个代码实现并打分。当用户要『开始一轮评测/评估项目』『对比同一需求下的多个实现』『对比一个仓库的多个分支』『按 basic + round rubric 打分』『跑 API/视觉/SAST/架构/治理/覆盖率评测并出中英双语报告』时使用。" --- diff --git a/skills/codearena-cn/references/EVAL_STANDARDS.md b/skills/code-arena-cn/references/EVAL_STANDARDS.md similarity index 100% rename from skills/codearena-cn/references/EVAL_STANDARDS.md rename to skills/code-arena-cn/references/EVAL_STANDARDS.md diff --git a/skills/codearena-cn/references/basic_eval_cases.md b/skills/code-arena-cn/references/basic_eval_cases.md similarity index 100% rename from skills/codearena-cn/references/basic_eval_cases.md rename to skills/code-arena-cn/references/basic_eval_cases.md diff --git a/skills/codearena-cn/references/example_round_eval_cases.md b/skills/code-arena-cn/references/example_round_eval_cases.md similarity index 100% rename from skills/codearena-cn/references/example_round_eval_cases.md rename to skills/code-arena-cn/references/example_round_eval_cases.md diff --git a/skills/codearena-cn/references/report_template.md b/skills/code-arena-cn/references/report_template.md similarity index 100% rename from skills/codearena-cn/references/report_template.md rename to skills/code-arena-cn/references/report_template.md diff --git a/skills/codearena-cn/references/scoring_overview.md b/skills/code-arena-cn/references/scoring_overview.md similarity index 100% rename from skills/codearena-cn/references/scoring_overview.md rename to skills/code-arena-cn/references/scoring_overview.md diff --git a/skills/codearena-cn/scripts/cap.mjs b/skills/code-arena-cn/scripts/cap.mjs similarity index 100% rename from skills/codearena-cn/scripts/cap.mjs rename to skills/code-arena-cn/scripts/cap.mjs diff --git a/skills/codearena-cn/scripts/check-tools.sh b/skills/code-arena-cn/scripts/check-tools.sh similarity index 100% rename from skills/codearena-cn/scripts/check-tools.sh rename to skills/code-arena-cn/scripts/check-tools.sh diff --git a/skills/codearena-cn/scripts/detect-ports.mjs b/skills/code-arena-cn/scripts/detect-ports.mjs similarity index 100% rename from skills/codearena-cn/scripts/detect-ports.mjs rename to skills/code-arena-cn/scripts/detect-ports.mjs diff --git a/skills/codearena-cn/scripts/lib/detect-ports.mjs b/skills/code-arena-cn/scripts/lib/detect-ports.mjs similarity index 100% rename from skills/codearena-cn/scripts/lib/detect-ports.mjs rename to skills/code-arena-cn/scripts/lib/detect-ports.mjs diff --git a/skills/codearena-cn/scripts/lib/http.mjs b/skills/code-arena-cn/scripts/lib/http.mjs similarity index 100% rename from skills/codearena-cn/scripts/lib/http.mjs rename to skills/code-arena-cn/scripts/lib/http.mjs diff --git a/skills/codearena-cn/scripts/lib/ui.mjs b/skills/code-arena-cn/scripts/lib/ui.mjs similarity index 100% rename from skills/codearena-cn/scripts/lib/ui.mjs rename to skills/code-arena-cn/scripts/lib/ui.mjs diff --git a/skills/codearena-cn/scripts/sast-rules.yaml b/skills/code-arena-cn/scripts/sast-rules.yaml similarity index 100% rename from skills/codearena-cn/scripts/sast-rules.yaml rename to skills/code-arena-cn/scripts/sast-rules.yaml diff --git a/skills/codearena-cn/scripts/setup-tools.sh b/skills/code-arena-cn/scripts/setup-tools.sh similarity index 100% rename from skills/codearena-cn/scripts/setup-tools.sh rename to skills/code-arena-cn/scripts/setup-tools.sh diff --git a/skills/codearena-cn/scripts/templates/api_test.template.mjs b/skills/code-arena-cn/scripts/templates/api_test.template.mjs similarity index 100% rename from skills/codearena-cn/scripts/templates/api_test.template.mjs rename to skills/code-arena-cn/scripts/templates/api_test.template.mjs diff --git a/skills/codearena-cn/scripts/templates/ui_test.template.mjs b/skills/code-arena-cn/scripts/templates/ui_test.template.mjs similarity index 100% rename from skills/codearena-cn/scripts/templates/ui_test.template.mjs rename to skills/code-arena-cn/scripts/templates/ui_test.template.mjs diff --git a/skills/codearena-cn/scripts/templates/visual_test.template.mjs b/skills/code-arena-cn/scripts/templates/visual_test.template.mjs similarity index 100% rename from skills/codearena-cn/scripts/templates/visual_test.template.mjs rename to skills/code-arena-cn/scripts/templates/visual_test.template.mjs diff --git a/skills/codearena-cn/scripts/tools-README.md b/skills/code-arena-cn/scripts/tools-README.md similarity index 100% rename from skills/codearena-cn/scripts/tools-README.md rename to skills/code-arena-cn/scripts/tools-README.md diff --git a/skills/codearena-en/SKILL.md b/skills/code-arena-en/SKILL.md similarity index 99% rename from skills/codearena-en/SKILL.md rename to skills/code-arena-en/SKILL.md index 1213073..94f1573 100644 --- a/skills/codearena-en/SKILL.md +++ b/skills/code-arena-en/SKILL.md @@ -1,5 +1,5 @@ --- -name: codearena-en +name: code-arena-en description: "Evaluate, score, and compare multiple implementations of the same requirement — different builds, or multiple branches of one repo. Use when the user asks to start/run an evaluation round, compare several implementations, compare branches of a repo, score projects against the basic + round rubrics, or run API / visual / SAST / architecture / governance / coverage checks and produce a bilingual (English + Chinese) report." --- diff --git a/skills/codearena-en/references/EVAL_STANDARDS.md b/skills/code-arena-en/references/EVAL_STANDARDS.md similarity index 100% rename from skills/codearena-en/references/EVAL_STANDARDS.md rename to skills/code-arena-en/references/EVAL_STANDARDS.md diff --git a/skills/codearena-en/references/basic_eval_cases.md b/skills/code-arena-en/references/basic_eval_cases.md similarity index 100% rename from skills/codearena-en/references/basic_eval_cases.md rename to skills/code-arena-en/references/basic_eval_cases.md diff --git a/skills/codearena-en/references/example_round_eval_cases.md b/skills/code-arena-en/references/example_round_eval_cases.md similarity index 100% rename from skills/codearena-en/references/example_round_eval_cases.md rename to skills/code-arena-en/references/example_round_eval_cases.md diff --git a/skills/codearena-en/references/report_template.md b/skills/code-arena-en/references/report_template.md similarity index 100% rename from skills/codearena-en/references/report_template.md rename to skills/code-arena-en/references/report_template.md diff --git a/skills/codearena-en/references/scoring_overview.md b/skills/code-arena-en/references/scoring_overview.md similarity index 100% rename from skills/codearena-en/references/scoring_overview.md rename to skills/code-arena-en/references/scoring_overview.md diff --git a/skills/codearena-en/scripts/cap.mjs b/skills/code-arena-en/scripts/cap.mjs similarity index 100% rename from skills/codearena-en/scripts/cap.mjs rename to skills/code-arena-en/scripts/cap.mjs diff --git a/skills/codearena-en/scripts/check-tools.sh b/skills/code-arena-en/scripts/check-tools.sh similarity index 100% rename from skills/codearena-en/scripts/check-tools.sh rename to skills/code-arena-en/scripts/check-tools.sh diff --git a/skills/codearena-en/scripts/detect-ports.mjs b/skills/code-arena-en/scripts/detect-ports.mjs similarity index 100% rename from skills/codearena-en/scripts/detect-ports.mjs rename to skills/code-arena-en/scripts/detect-ports.mjs diff --git a/skills/codearena-en/scripts/lib/detect-ports.mjs b/skills/code-arena-en/scripts/lib/detect-ports.mjs similarity index 100% rename from skills/codearena-en/scripts/lib/detect-ports.mjs rename to skills/code-arena-en/scripts/lib/detect-ports.mjs diff --git a/skills/codearena-en/scripts/lib/http.mjs b/skills/code-arena-en/scripts/lib/http.mjs similarity index 100% rename from skills/codearena-en/scripts/lib/http.mjs rename to skills/code-arena-en/scripts/lib/http.mjs diff --git a/skills/codearena-en/scripts/lib/ui.mjs b/skills/code-arena-en/scripts/lib/ui.mjs similarity index 100% rename from skills/codearena-en/scripts/lib/ui.mjs rename to skills/code-arena-en/scripts/lib/ui.mjs diff --git a/skills/codearena-en/scripts/sast-rules.yaml b/skills/code-arena-en/scripts/sast-rules.yaml similarity index 100% rename from skills/codearena-en/scripts/sast-rules.yaml rename to skills/code-arena-en/scripts/sast-rules.yaml diff --git a/skills/codearena-en/scripts/setup-tools.sh b/skills/code-arena-en/scripts/setup-tools.sh similarity index 100% rename from skills/codearena-en/scripts/setup-tools.sh rename to skills/code-arena-en/scripts/setup-tools.sh diff --git a/skills/codearena-en/scripts/templates/api_test.template.mjs b/skills/code-arena-en/scripts/templates/api_test.template.mjs similarity index 100% rename from skills/codearena-en/scripts/templates/api_test.template.mjs rename to skills/code-arena-en/scripts/templates/api_test.template.mjs diff --git a/skills/codearena-en/scripts/templates/ui_test.template.mjs b/skills/code-arena-en/scripts/templates/ui_test.template.mjs similarity index 100% rename from skills/codearena-en/scripts/templates/ui_test.template.mjs rename to skills/code-arena-en/scripts/templates/ui_test.template.mjs diff --git a/skills/codearena-en/scripts/templates/visual_test.template.mjs b/skills/code-arena-en/scripts/templates/visual_test.template.mjs similarity index 100% rename from skills/codearena-en/scripts/templates/visual_test.template.mjs rename to skills/code-arena-en/scripts/templates/visual_test.template.mjs diff --git a/skills/codearena-en/scripts/tools-README.md b/skills/code-arena-en/scripts/tools-README.md similarity index 100% rename from skills/codearena-en/scripts/tools-README.md rename to skills/code-arena-en/scripts/tools-README.md diff --git a/skills/skill-installer/SKILL.md b/skills/skill-installer/SKILL.md index af15305..c76fbb3 100644 --- a/skills/skill-installer/SKILL.md +++ b/skills/skill-installer/SKILL.md @@ -71,4 +71,4 @@ skill-installer/ │ ├── playwright-cli.js │ └── openspec.js └── assets/manifests/ # runtime manifests (gitignored) -``` \ No newline at end of file +```