codeup_skill

Overview

This skill is a Python-based toolkit for managing Codeup (Alibaba Cloud Yunxiao) repositories, organizations, branches, files, and merge requests. It exposes a single CLI entrypoint (scripts/codeup.py) with many subcommands that return JSON results. The skill is designed to make common repo, branch, MR, and organization operations scriptable and automatable.

How this skill works

The tool reads a personal access token from an environment variable and invokes Codeup APIs through a lightweight client. Commands accept org_id and repo_id (either numeric ID or URL-encoded namespace/path) and return JSON output suitable for automation. Typical flows: list organizations to get org_id, list or resolve repositories to get repo_id, then run branch/file/MR operations with the appropriate flags.

When to use it

• Automating repository tasks like listing repos, creating or deleting branches, and reading files.
• Managing organization structure: listing departments, searching members, and querying roles.
• Creating, reviewing, updating, or merging merge requests as part of CI/CD or developer workflows.
• Scripting bulk updates to files or branches across multiple repositories.
• Integrating Codeup queries into chatbots or tool-assisted code review workflows.

Best practices

• Set YUNXIAO_ACCESS_TOKEN in your environment before running any command and ensure it has the required scopes.
• Use URL-encoded repo paths when you only have a repository URL to avoid an extra lookup.
• Prefer JSON output parsing in automation scripts rather than human parsing of stdout.
• Validate org_id and repo_id with list_organizations or list_repositories before mutating operations.
• Use branch naming and MR titles/descriptions that clearly reflect scope and intent for easier reviews.

Example use cases

• Fetch current user and organization IDs, then list all repositories to build an inventory.
• Create a feature branch from master across multiple repos and open a merge request automatically.
• Retrieve file content from a specific branch to populate deployment or documentation systems.
• List open merge requests and add a standardized review comment or approve programmatically.
• Search organization members to map owners for code ownership or on-call rotations.