본문으로 건너뛰기
cccskills
무료GitHub에 공개

document-carla-feature

Fill documentation gaps identified by a CARLA documentation audit, following the project's writing style. Work through one category at a time, assess which findings deserve entries, update source files, and report changes and skipped findings.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

Writes the missing CARLA documentation that the audit found — Python API entries in PythonAPI/docs/*.yml, sensors in ref_sensors.md, catalogue actors, broken links and nav entries — one audit category at a time, in CARLA's house style. Use when the user asks to "document this feature", "write the docs for X", "fix the audit findings", or names a category such as "the Python API part".

설치 방법 보기

이럴 때 유용합니다

  • Add missing Python API documentation
  • Expand sensor reference documentation
  • Review outdated API entries for renaming or removal
  • Address audit findings and explain skipped items

포함된 파일(7)

  • SKILL.md3.7 KB
  • references/python_api.md5.6 KB
  • references/sensors.md2.5 KB
  • references/style.md2.1 KB
  • scripts/check_env.sh1.3 KB
  • scripts/env.sh1.2 KB
  • scripts/yml_target.py8.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Document a CARLA feature

The writing half of the documentation programme. audit-carla-docs decides what is missing and writes Docs/audit_carla_docs.md; this skill writes it.

Paths. scripts/… and references/… are relative to the directory holding this SKILL.md, not to the user's working directory.

One category at a time

The audit's signals are independent, and so is the work. Each category below touches its own files, so one person can take one category, or several agents can run all of them at once without colliding. Never work two categories in one pass — the rules differ and the review gets muddled.

categoryaudit signalfiles it editsstatus
python-apibinding, stalePythonAPI/docs/*.yml, then regeneratereferences/python_api.md
changelogchangelogwherever the feature belongsnot written yet
sensorssensorDocs/ref_sensors.mdreferences/sensors.md
cataloguecatalogueDocs/catalogue_*.mdnot written yet
linkslinkthe page holding the linknot written yet
navorphanmkdocs.ymlnot written yet

Instructions

Progress:
- [ ] Step 1: Check prerequisites (bash scripts/check_env.sh)
- [ ] Step 2: Pick ONE category and read its reference in full
- [ ] Step 3: Read the matching section of Docs/audit_carla_docs.md
- [ ] Step 4: Triage — not every finding should be documented
- [ ] Step 5: Write the entries, following references/style.md
- [ ] Step 6: Remove what no longer exists, checking first that it was not renamed
- [ ] Step 7: Verify, and report what you skipped and why

Step 4 is not optional. The audit reports what it sees, not what deserves an entry; it has no way to tell a public API from binding plumbing. Each reference lists the exemptions for its category. Say in the report which findings you skipped and why — a silent skip reads as an oversight later.

Step 5 always obeys references/style.md, which is shared by every category: what a CARLA doc sentence says, and what it never says.

Step 6 removes, it does not deprecate. The reference describes what exists now, so a name the code no longer has is deleted outright — no tombstone and no "removed in" marker. Check it was not simply renamed first; most of the time it was, and then the entry moves instead of going.

Gotchas

  • Docs/python_api.md is generated. Editing it directly is lost on the next regeneration, and the audit will not notice.
  • A finding is a candidate, not an instruction. Documenting an internal name makes the reference worse, not better.
  • Re-run the audit after a pass. The counts moving is the only evidence the work landed.

Output

Edited source files, and a report naming what was written, what was skipped and why. Nothing is committed.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Add a message type to CARLA's native ROS 2 interface. Create its C++ data structure, serialization code for transmission, type identity hash, registration, and tests, with Docker-based hash calculation and build checks.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Adding a standard ROS 2 message type missing from CARLA
  • Defining a custom carla_msgs message
  • Investigating type-hash warnings
carla-simulator/carla1.5만2026년 10월 18일 업데이트

Extend CARLA’s native ROS 2 interface to publish sensor data or receive vehicle commands. Covers topic implementation, registration, data connections, and verification, plus adding middleware, the communication layer used to exchange messages.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Publish obstacle sensor data to ROS 2
  • Add a topic for vehicle speed commands
  • Integrate another communication middleware
carla-simulator/carla1.5만2026년 10월 18일 업데이트

Summarize ScenarioRunner results to see which scenarios passed and which checks failed. Compare runs before and after changes, or analyze recorded driving to produce measurements and plots of vehicle distance and deviation from the lane center.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Checking scenario pass and fail results
  • Comparing results before and after controller changes
  • Plotting vehicle distances from a recorded run
carla-simulator/carla1.5만2026년 10월 18일 업데이트

Checks a local CARLA checkout for missing API documentation, outdated references, broken links, and pages absent from navigation. Produces a grouped Markdown report without building the project or running the simulator.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Reviewing documentation before a release
  • Finding missing or outdated API references
  • Checking broken links and navigation gaps
carla-simulator/carla1.5만2026년 10월 18일 업데이트

Read and display CARLA object bounding boxes, then project them onto a camera image as 2D rectangles. Export an annotated PNG and box coordinates in JSON for object detection annotation work.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Adding vehicle boxes to a camera image
  • Exporting box coordinates for detection annotations
  • Checking vehicle dimensions
carla-simulator/carla1.5만2026년 10월 18일 업데이트

Builds CARLA's ue4-dev branch on Linux, producing the Unreal Engine 4.26 editor, server modules, and an installed Python client package. Fetches required content, optionally compiles native ROS 2 support, and verifies the build against a source-built server.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Building CARLA ue4-dev from source
  • Compiling CARLA with native ROS 2 support
  • Building the Python client for an existing environment
carla-simulator/carla1.5만2026년 10월 18일 업데이트

carla-simulator의 스킬 모두 보기

이 스킬의 문제 신고