AGENTS.md ยท diff
git:20261016.a888bc6 to git:20261016.af01e95
0 added, 1 removed. Audit A to A.
# Repository Guidance
This repository distributes reusable agent skills for Codex, Claude Code, and other clients that load `SKILL.md` directories. It contains no product source code.
- Keep every skill independent of a specific company, product, repository name, internal host, deployment path, or agent client. When a step depends on one client, label it as client-specific and give a client-neutral alternative or an explicit stop condition.
- Put private project facts in a local profile or optional private profiles checkout and access them through `rumo-project-profile`.
- Resolve bundled scripts relative to the installed skill directory.
- Preserve unrelated working-tree changes and installed skills from other sources.
- Validate frontmatter, metadata, relative links, helper scripts, installers, and the catalog before push.
- Never commit or print passwords, tokens, private keys, or private certificate material.
- State explicit stop conditions for ambiguous or state-changing workflows.
- Write every skill in your own words. Do not copy text from other projects, and do not add attribution notes or separate license files inside skill directories.
Commits and pushes follow `skills/rumo-git-commit/SKILL.md` and repository-local instructions.
## Layout
- `skills/` holds the default skills that the installers always link; `extras/` holds optional skills installed with `-Extras` or `--extras`. A default skill must not link to an extra.
- - When a skill is renamed, merged, or retired, add `<old-name><TAB><new-name or ->` to `scripts/skill-migrations.tsv`. The installers use it to explain upgrades and the validator rejects stale references.
- Follow the skill structure in `CONTRIBUTING.md` and `skills/rumo-prose/references/agent-docs.md`.
## Skill Language Policy
- In `skills/*/SKILL.md` and `extras/*/SKILL.md`, write frontmatter `description` and the Markdown body in English. Clients select skills from frontmatter `name` and `description` only, so keep both self-sufficient.
- `agents/openai.yaml` in each skill is optional Codex UI metadata; other clients ignore it. Keep `interface.display_name` in English only. Keep `interface.short_description` in Chinese so the skill list can show an English name with a Chinese explanation. Prefer English for `interface.default_prompt`.
- Preserve Chinese only when it is required as literal product data, such as UI text, branch/product labels, user trigger phrases, commit-message requirements, or examples that must intentionally produce Simplified Chinese output.
- Reference files under each skill's `references/` may keep Chinese source material, scanned product text, and UI/business examples when translating them would reduce their value as product evidence.