repo-development
Maintain the Yuxi monorepo: Docker Compose workflows, backend/frontend/CLI checks, formatting, release versioning, and contribution docs.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- repo-development
- license
- MIT
- metadata
- { "disco-role": "operating" }
- description
- Maintain the Yuxi monorepo: Docker Compose workflows, backend/frontend/CLI checks, formatting, release versioning, and contribution docs.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/development-workflows.md5.2 KB
- 参考文档references/testing-and-release.md4.5 KB
- 参考文档references/troubleshooting.md3.9 KB
03 SKILL.md 正文
Repo Development
Use this sub-skill when the task is about keeping the Yuxi repository healthy: editing code, choosing the smallest valid check set, formatting, versioning, release prep, or updating maintainer docs.
Owns
- Monorepo boundaries for
backend/,web/,packages/yuxi-cli/,docs/,scripts/, and Docker Compose. - Hot-reload development in the Compose stack.
- Safe backend import, CLI pytest, frontend unit, and frontend lint checks.
- Service-required backend integration/e2e checks when the stack is already running.
- Format, version bump, changelog, and contribution workflow.
Does not own
- Product runtime behavior, agent logic, KB/OCR internals, or external-provider troubleshooting except where they affect maintainer checks.
- Starting or stopping Docker Compose services from the bundled check script.
Read first
references/development-workflows.mdreferences/testing-and-release.mdreferences/troubleshooting.md
Safe working rules
- Treat Docker Compose as the canonical development runtime.
- Prefer no-write checks when you only need verification.
- The frontend lint path can rewrite files; use the bundled check-only command unless you explicitly want auto-fix.
- Keep service-required tests opt-in; the bundled script never starts or stops services for you.
- Update changelog and docs navigation when the change is user-visible or adds formal docs.
- Avoid unrelated refactors, broad formatting, and secret leakage.
Recommended command path
- Backend package import:
./scripts/run-selected-checks.sh backend-import --run - CLI pytest:
./scripts/run-selected-checks.sh cli-pytest --run - Frontend unit:
./scripts/run-selected-checks.sh frontend-unit --run - Frontend lint check:
./scripts/run-selected-checks.sh frontend-lint --run - Service-required backend checks:
./scripts/run-selected-checks.sh backend-integration backend-e2e --with-services --run - Mutating repo-wide cleanup:
make format - Release/version policy: read
references/testing-and-release.md; only use the repo-owned version-bump helper inside a checkout after an explicit release task and diff review.
If the command choice is unclear
Use the bundled references to decide the smallest safe command set. If a check depends on running services or external credentials, surface that requirement before claiming success.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.