Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified .DS_Store
Binary file not shown.
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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 <name>` 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

Expand Down Expand Up @@ -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
Expand All @@ -156,7 +156,7 @@ A skill change is complete when:

- **Add a new skill**: create `skills/<name>/` 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/<name>.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/<name>.js` (and shared `lib/`); test `init`/`update`/`delete`/`status --target <name>` 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
Expand All @@ -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.
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 / 架构 / 治理 / 覆盖率评测。

Expand All @@ -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 中输入以下指令即可触发:**
Expand All @@ -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.

Expand All @@ -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:**
Expand Down
Binary file modified skills/.DS_Store
Binary file not shown.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: codearena-cn
name: code-arena-cn
description: "评测/对比同一需求(或同一代码仓多个分支)的多个代码实现并打分。当用户要『开始一轮评测/评估项目』『对比同一需求下的多个实现』『对比一个仓库的多个分支』『按 basic + round rubric 打分』『跑 API/视觉/SAST/架构/治理/覆盖率评测并出中英双语报告』时使用。"
---

Expand Down
Original file line number Diff line number Diff line change
@@ -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."
---

Expand Down
2 changes: 1 addition & 1 deletion skills/skill-installer/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,4 +71,4 @@ skill-installer/
│ ├── playwright-cli.js
│ └── openspec.js
└── assets/manifests/ # runtime manifests (gitignored)
```
```