القائمة
Set up the development environment for the project. Use when starting work on the project, when dependencies are out of sync, or to fix environment setup failures.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Build the project and automatically fix any build errors, compilation failures, or type mismatches. Use when the project fails to build, shows "broken" states, or after making significant changes.
Perform a "hard reset" of the development environment. Use when dependencies are corrupted, lockfiles are out of sync, or environment tools (Trunk/uv) are in an inconsistent state.
Fix a GitHub issue end-to-end. Use when given an issue number to fix, implementing bug fixes, or addressing reported problems.
Self-improvement skill for evolving Claude Code configuration. Use when you notice repeated mistakes, want to add new workflows, or optimize the development experience. Enables Claude to improve its own CLAUDE.md, skills, hooks, and agents.
Run linters and fix violations, formatting errors, or style mismatches using Trunk. Use when code quality checks fail, before submitting PRs, or to repair "broken" linting states.
Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution.
| name | setup-dev-env |
| description | Set up the development environment for the project. Use when starting work on the project, when dependencies are out of sync, or to fix environment setup failures. |
This skill automates the process of setting up the development environment to ensure all tools and dependencies are correctly installed and configured.
.python-versiontrunk installationuv installationmake setuptrunk install to fetch managed linters and formattersRead the .python-version file in the workspace root. Ensure the current Python environment matches this version. If there's a mismatch, inform the user to switch Python versions (e.g., using pyenv or asdf).
Check if trunk and uv are installed.
If not found, advise the user to install them. On macOS, use:
brew install trunk-io uv
Run the following command at the workspace root to install all project dependencies. Refer to ../common-references/python-commands.md for more commands.
make setup
This command runs dev/setup.sh, which installs uv if needed (via pip), creates a virtual environment, and syncs dependencies.
Trunk manages linters and formatters hermetically. Run the following command to ensure all required tools are downloaded and ready.
trunk install
trunk and uv are installed..python-version.To ensure the environment is fully operational:
verifier subagent (../../agents/verifier.md). This confirms that the freshly installed dependencies allow for a successful build, pass lint checks, and satisfy all unit tests.verifier fails, follow its reporting to resolve environment-specific issues.