agent-tools

OSSCA Chromium 팀용 AI 코딩 에이전트 설정 도구 모음입니다.

Chromium 소스 트리에는 //agents 아래에 에이전트 스킬(SKILL.md 디렉터리)이 포함되어 있지만, 기본 설치 도구는 Gemini CLI 전용입니다. 이 저장소의 install-skills.py는 그 스킬들을 Claude Code와 Codex CLI가 인식하는 위치에 symlink로 설치해 줍니다.

요구사항

• Python 3.9+
• Chromium 체크아웃 (src/ 디렉터리)
• Claude Code 또는 Codex CLI

설치

git clone https://github.com/OSSCA-chromium/agent-tools.git
python3 agent-tools/install-skills.py --src /path/to/chromium/src

--src를 생략하면 CHROMIUM_SRC 환경변수, 그다음 현재 디렉터리 기준 자동 탐지를 시도합니다. 셸 설정에 한 번 넣어두면 편합니다:

export CHROMIUM_SRC=$HOME/chromium/src

무엇이 어디에 설치되나

에이전트	설치 위치	범위
Claude Code	<src>/.claude/skills/<이름>	해당 체크아웃 전용
Codex CLI	<src>/.agents/skills/<이름>	해당 체크아웃 전용

.agents/skills/는 agentskills.io 표준 경로로, Codex 외에 Antigravity도 같은 위치를 읽습니다 (Chromium 업스트림 agents/skills/setup.py link가 쓰는 곳과 동일).

모두 symlink라서 git pull/gclient sync로 스킬 원본이 갱신되면 자동으로 따라갑니다. 설치 디렉터리에는 * gitignore가 함께 생성되어 Chromium 트리의 git status를 오염시키지 않으며, 아무것도 커밋되지 않습니다.

스킬 세트

세트	원본 위치	내용
core	agents/skills/	histograms, fuzzing, disable-test 등 공용 스킬
shared	agents/shared/skills/	gerrit-cli, git-cl-helper, utr, cl-description 등 워크플로우
code-health	agents/projects/code-health/	hub, histogram-cleanup, lint-sync 등 정리 작업
bedrock	agents/projects/bedrock/	Project Bedrock (test-conversion 등)
ossca	이 저장소의 skills/	OSSCA 커스텀 스킬

일부만 설치하려면:

python3 install-skills.py --sets core code-health --agents claude

기타 명령

python3 install-skills.py --list        # 설치 대상 미리보기
python3 install-skills.py --dry-run     # 실제 변경 없이 동작 확인
python3 install-skills.py --uninstall   # 이 도구가 만든 링크만 제거
python3 install-skills.py --force       # 다른 곳을 가리키는 기존 링크 교체

• 재실행해도 안전합니다(이미 설치된 스킬은 skip).
• --uninstall은 Chromium agents/ 또는 이 저장소 skills/를 가리키는 symlink만 제거하므로 직접 만든 다른 스킬은 건드리지 않습니다.

주의사항

• 예전 버전은 Codex 스킬을 사용자 전역(~/.codex/skills)에 설치했습니다. --uninstall --agents codex가 그 잔재도 함께 정리하므로, 구버전 사용자는 재설치 전에 한 번 실행하세요.
• Chromium 체크아웃을 옮기거나 지우면 링크가 깨집니다. 옮긴 후 --force로 재실행하면 복구됩니다.
• Gemini CLI / Antigravity 사용자는 업스트림 도구를 쓰세요: vpython3 agents/skills/setup.py, vpython3 agents/extensions/install.py

OSSCA 커스텀 스킬 추가하기

skills/<스킬이름>/SKILL.md 형태로 디렉터리를 추가하면 됩니다. SKILL.md는 YAML frontmatter에 name과 description이 필요합니다:

---
name: my-skill
description: 언제 이 스킬을 쓰는지 한 줄 설명
---

# My Skill

스킬 내용...

추가 후 각자 install-skills.py를 다시 실행하면 반영됩니다.

AI 기여 정책

AI 도구로 Chromium에 기여할 때는 //agents/ai_policy.md를 반드시 읽어보세요. 핵심: 제출하는 코드는 전부 본인이 이해하고 자체 리뷰해야 하며, 리뷰어의 질문에 답할 수 있어야 합니다.