AgentSkillsCN

coco-cli

ODB++ PCB 设计文件分析 CLI。支持查询层、网络、元件,测量特征间距,分析网络间隙,并渲染 PNG 图像。

SKILL.md
--- frontmatter
name: coco-cli
description: ODB++ PCB design file analysis CLI. Query layers/nets/components, measure feature distances, analyze net clearances, render PNG images.
license: LicenseRef-Proprietary
compatibility: Requires coco CLI binary. Supports Windows, macOS, Linux.
metadata:
  author: Pentacube
  version: "0.1.0"

coco CLI

Command-line tool for analyzing ODB++ PCB design files.

When to Use

Use coco CLI in these situations:

  1. ODB++ folder detected - Directory containing matrix/, steps/, misc/ folders
  2. PCB-related queries - Layer, net, component, feature, distance measurement requests
  3. DFM verification - Clearance checks, short detection, design rule validation
  4. Keywords present - ODB++, PCB, Gerber, layer, netlist, DRC

Installation

bash
# Check installation
coco --help

# If not installed
# Linux/macOS:
./scripts/install.sh
# Windows:
./scripts/install.ps1

ODB++ Folder Identification

ODB++ folders are identified by internal structure (folder name is irrelevant):

code
<any_name>/       <- path for --input
├── matrix/
├── steps/
└── misc/

If matrix/, steps/, misc/ folders are all present, it's an ODB++ root.

Command Usage

IMPORTANT: Always run --help first to discover available commands and options:

bash
# Discover all commands
coco --help

# Get specific command options (REQUIRED before using any command)
coco <command> --help

Basic Workflow

bash
# 1. Discover commands
coco --help

# 2. Check command options
coco list-layers --help

# 3. Run with appropriate options
coco list-layers --input <odb_path>

Use Cases

Troubleshooting

SymptomSolution
command not foundRun scripts/install.sh
step not foundSpecify --step <name> option