跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

unoplat-code-confluence-cli

Use the Unoplat Code Confluence CLI to run the local app, configure providers, add repositories, and generate AGENTS.md artifacts with automatic PR publication. Trigger when users mention Unoplat, Code Confluence, repository setup, AGENTS.md generation, or agent-md workflows.

unoplat · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add unoplat/unoplat-code-confluence --skill unoplat-code-confluence-cli

技能说明


name: unoplat-code-confluence-cli description: "Use the Unoplat Code Confluence CLI to run the local app, configure providers, add repositories, and generate AGENTS.md artifacts with automatic PR publication. Trigger when users mention Unoplat, Code Confluence, repository setup, AGENTS.md generation, or agent-md workflows." metadata: version: "0.1.0"

Unoplat Code Confluence CLI

Use the ucc CLI to manage the local Unoplat Code Confluence app, add repositories, open setup pages, and generate or update AGENTS.md artifacts after refreshing latest code.

Capabilities

  • Starts, updates, stops, or destroys the local Unoplat Code Confluence Docker Compose stack.
  • Opens repository-provider and model-provider setup pages in the local frontend.
  • Adds a repository from an HTTPS or SSH git remote URL without running ingestion.
  • Starts AGENTS.md generation/update after refreshing latest code.
  • Relies on the backend workflow to publish a pull request automatically when AGENTS.md generation completes.
  • Emits JSON results that agents can summarize for users.

When to Use

Use this skill when the user asks to:

  • Use Unoplat Code Confluence or the ucc CLI.
  • Start, stop, update, or reset the local Code Confluence app.
  • Configure repository-provider tokens or model providers for Code Confluence.
  • Add, track, import, or onboard a repository into Code Confluence.
  • Generate, update, refresh, or publish AGENTS.md artifacts for a repository.
  • Run agent-md for a repository.

Command Availability

Always use a trusted ucc executable installed on the user's PATH. If ucc is not available, help the user install it on PATH with uv tool install.

1. Check for ucc

ucc --help >/dev/null 2>&1 && echo "UCC_AVAILABLE" || echo "UCC_NOT_FOUND"

If available, run commands as:

ucc <command>

2. If ucc is not available, check for uv

uv --version >/dev/null 2>&1 && echo "UV_AVAILABLE" || echo "UV_NOT_FOUND"

If uv is available, ask for user approval and then install the CLI on PATH:

uv tool install "git+https://github.com/unoplat/unoplat-code-confluence.git#subdirectory=unoplat-code-confluence-cli"
ucc --help

After installation, run all commands as ucc <command>. The package requires Python >=3.13; let uv resolve the tool environment.

3. If neither ucc nor uv is available

Stop and ask the user to install a prerequisite. Do not install uv, run remote installer scripts, or mutate the user's Python environment automatically.

Tell the user:

The Unoplat CLI is not available, and uv is not installed.
Please install uv from the official documentation and retry:
https://docs.astral.sh/uv/getting-started/installation/

Then install the CLI on PATH:
uv tool install "git+https://github.com/unoplat/unoplat-code-confluence.git#subdirectory=unoplat-code-confluence-cli"

Repository URL Requirements

For repository add and AGENTS.md operations, use the repository git remote URL. Acceptable forms include:

https://github.com/owner/repo.git
git@github.com:owner/repo.git

Rules:

  • The URL must end with .git.
  • Prefer git remote get-url origin when operating inside the target repository.
  • If the repository URL is ambiguous or missing, ask the user before proceeding.

Workflows

In the examples below, ucc is expected to be installed on PATH. If it is not, follow the Command Availability instructions above to install it with uv tool install.

Start or Prepare the Local App

Use when the user asks to start Code Confluence or before setup/repository operations if the service may not already be running.

ucc service run

This starts the pinned local app release and installs the latest Unoplat Code Confluence app release on first run. The CLI resolves app releases from GitHub tags matching unoplat-code-confluence-vMAJOR.MINOR.PATCH; component releases and arbitrary version selection are not part of the CLI workflow. It may fetch GitHub release metadata and pull Docker images.

Prerequisites:

  • Docker daemon / Docker Desktop is running.
  • Docker Compose support is available.
  • Network access is available for first install/update and image pulls.

Summarize the JSON result, especially installed_tag, available_tag, update_available, installed_release, and warnings.

Update the Local App

Ask for confirmation before updating unless the user explicitly requested an update. Updates always target the latest GitHub app release whose tag matches unoplat-code-confluence-vMAJOR.MINOR.PATCH; do not ask the user to choose a historical version.

ucc service update

Summarize the previous_tag, installed_tag, available_tag, and warnings.

Stop the Local App

Safe stop without deleting volumes:

ucc service stop

Destroy the Local App

Destructive: deletes Docker Compose volumes. Only run after explicit user confirmation.

ucc service destroy

Warn the user that local app volumes/data will be removed.

Check Setup Status

Use this to verify repository-provider and model-provider setup without exposing secrets:

ucc service status

The CLI verifies the repository-provider token through Flow Bridge's /user-details endpoint for the configured provider, and verifies model-provider configuration through Query Engine's /v1/model-config endpoint. It reports only setup status, provider/model identifiers, and whether a model credential exists.

Configure Repository Provider Token

Before adding repositories, ensure repository-provider token setup is complete:

ucc setup token-repo-provider

This ensures the local app is running and opens the setup page in the user's browser. Ask the user to complete the browser flow before continuing.

Default frontend URL:

http://127.0.0.1:3000/onboarding

Configure Model Provider

Use when the user needs model-provider setup:

阅读完整来源 ↗