setup-project
Guide a repository into the project-local `.agents/` conventions used by retained runtime-kit dispatcher skills.
- License 许可
- MIT
- 最近更新
- 2026-08-29
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- setup-project
- description
- Guide a repository into the project-local `.agents/` conventions used by retained runtime-kit dispatcher skills.
02 资源文件 1
- 脚本scripts/setup-project.sh5.9 KB
03 SKILL.md 正文
Setup Project
Contract
Prereqs:
- Run inside the target repository root unless the user explicitly names another repository path.
- The target repository is a git work tree.
- First-time host/global runtime installation has already been handled outside
this workflow by
scripts/setup.shand the released runtime install path. - Existing project-local files are never overwritten without explicit user approval.
Inputs:
- Optional repository path when setting up another checkout.
- Dry-run or apply intent. Dry-run is the default.
- Required apply-time validation command for
.agents/scripts/pre-pr.sh, passed as--pre-pr-command <command>. - Optional
--bootstrap-command,--deploy-command, and--release-commandvalues to create retained dispatcher scripts.
Outputs:
- A repository adoption report covering
.agents/,.agents/scripts/,.agents/skills/, retained dispatcher scripts, and common validation command candidates. - In apply mode,
.agents/scripts/pre-pr.shcreated from an explicit validation command and optional retained dispatcher scripts created from explicit commands. - A blocking diagnostic when an adopted repository is missing an executable
.agents/scripts/pre-pr.sh.
Failure modes:
- The target path is not a git work tree.
- Apply mode is requested without
--pre-pr-commandwhenpre-pr.shis missing. - A target script already exists and replacement was not explicitly approved.
- A requested command is empty or unsupported by the generated Bash wrapper.
- The adopted repository is missing executable
pre-pr.sh.
Entrypoint
Use the bundled helper in dry-run mode first:
$HOME/.claude/plugins/meta/skills/setup-project/scripts/setup-project.sh \
--repo "$repo_root" \
--dry-run
Apply only after the project validation command is known:
$HOME/.claude/plugins/meta/skills/setup-project/scripts/setup-project.sh \
--repo "$repo_root" \
--apply \
--pre-pr-command "bash scripts/ci/all.sh"
Optional retained dispatchers are explicit:
$HOME/.claude/plugins/meta/skills/setup-project/scripts/setup-project.sh \
--repo "$repo_root" \
--apply \
--pre-pr-command "bash scripts/ci/all.sh" \
--bootstrap-command "bash scripts/bootstrap.sh" \
--deploy-command "bash scripts/deploy.sh" \
--release-command "bash scripts/release.sh"
Workflow
- Resolve the target repository root with
git rev-parse --show-toplevel. - Inspect
.agents/,.agents/scripts/,.agents/skills/, retained dispatcher scripts, and common validation entrypoints. - Classify the repository as:
unadoptedwhen.agents/is absent.partialwhen.agents/exists but required project runtime pieces are incomplete.adoptedwhen.agents/exists and executablepre-pr.shis present.
- In dry-run mode, report the classification and proposed next action without writing files.
- In apply mode, create
.agents/scripts/and.agents/skills/as needed. - Create
.agents/scripts/pre-pr.shonly from an explicit--pre-pr-command; never create a successful no-op validation gate. - Create optional
bootstrap,deploy, andreleasescripts only from their explicit command flags. - Refuse destructive overwrite unless the user explicitly approves it.
- Report created paths and the final adoption status.
Boundary
This skill owns project-local runtime adoption only. It does not install host
tools, mutate global Codex or Claude runtime homes, rename the bootstrap
dispatcher, or create runtime-kit managed skills. Project-local skill
scaffolding remains owned by create-project-skill; use that workflow when a
repository needs .agents/skills/<skill>/.
04 同仓库更多 Skills
removable-skill
暂无简介
removable-skill
暂无简介
removable-project-skill
Fixture project-local skill used to prove remove-project-skill dry-run coverage.
project-sample-skill
Fixture project-local skill used to prove create-project-skill governance coverage.
project-local-skill
Fixture project-local skill used by runtime-kit project-local smoke checks.
topic-radar
Aggregate read-only AI and technology trend signals (Polymarket, Hacker News, GitHub, arXiv, Hugging Face, news search) into source-grounded Markdown or JSON; the lower-level data engine behind `daily-brief`.