AGENT SKILL

build-from-source

Use for tasks that require compiling, building, cross-compiling, porting, or repairing an existing codebase — "build X from source", "fix the build", "port to Y", "get the tests green". A failure-first protocol that avoids thrashing on long builds.

License 许可
Apache-2.0
所属仓库
RUC-NLPIR/FlashRSI
最近更新
2026-11-12
Stars
★ 394
Forks
23

01 前言 Front Matter

name
build-from-source
description
Use for tasks that require compiling, building, cross-compiling, porting, or repairing an existing codebase — "build X from source", "fix the build", "port to Y", "get the tests green". A failure-first protocol that avoids thrashing on long builds.

03 SKILL.md 正文

Build / port / repair protocol

Long builds fail when the agent thrashes — retrying the same command or guessing at an error. Follow this order.

  1. Read the build docs first. Find HACKING.*, README*, INSTALL*, Makefile targets, and CI config. Identify the exact configure / build / test commands and required toolchain versions.

  2. Install dependencies once, non-interactively. DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y <pkgs>. Confirm tools are on PATH before building.

  3. Configure → build → test, one stage at a time, capturing the FIRST error. Use make -j$(nproc). Tee the log: <cmd> 2>&1 | tee /tmp/build.log. The first error is the real one; later lines are fallout.

  4. Watch memory on parallel builds. -j$(nproc) can exhaust RAM and get the build Killed with no compiler error (common with Coq/OCaml/LLVM builds). If the build dies without an error message, re-run at -j4 and monitor free -h. A slower build that finishes beats a fast build that OOMs.

  5. Cross-compiling to another target/architecture: install the matching toolchain (e.g. apt-get install -y gcc-mips-linux-gnu) and make the build use it — set CC/CXX/LD, or the project's --host/--target/ CROSS_COMPILE variables — instead of silently producing a host binary. Verify the output with file (it must report the target architecture, e.g. ELF 32-bit … MIPS).

  6. Reproduce the stated failure with the exact command before changing anything, so you have a baseline to compare against.

  7. Change one thing at a time, rebuild, check. If a fix does not change the error, revert it — do not stack guesses.

  8. Verify with the task's stated acceptance command (the specific test target or binary invocation), not a proxy.

  9. Checkpoint long builds — write a small script so a re-run resumes from the last successful stage instead of restarting from zero.

04 同仓库更多 Skills

RUC-NLPIR
RUC-NLPIR/FlashRSI

dynamic-resources

Example skill loaded from resources_discover

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

hermes-agent

Use the FlashRSI Hermes Snapshot's headless Python runtime, tools, sessions, and compression paths.

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

skill-installer

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

review-agent

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

plugin-creator

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.

★ 394