liyi: Instructions file for Codex

AGENTS.md

This repository is 立意 (Lìyì) — a convention and tooling project for making intent explicit, persistent, and reviewable in AI-assisted software development.

立意 is not an agent skill collection — it defines the practice and ships the tools (linter, spec format, agent skill template) that other projects adopt. One of its deliverables is an agent skill template that downstream repositories can use to bootstrap their own AGENTS.md and contributing workflows.

Before making any changes, read the contributing guide that matches the predominant language of the current user session:

• 中文会话 → docs/contributing-guide.zh.md
• English session → docs/contributing-guide.en.md

If the session language is unclear, default to the Chinese version.

The contributing guide covers project structure, content workflows, code style, commit message conventions, AIGC policy compliance, and the validation checklist. All of those rules are authoritative and must be followed.

Code style (quick reference)

For Rust code:

• Conform to official rustfmt style.
• Keep free from Clippy lints.

Before committing, run make lint (rustfmt check, Clippy, the linter's own self-check, and the agent-template sync check) and ensure it passes, or make verify to also run the test suite. Both gates abort at the first failure and end with a success banner (lint: all gates passed / verify: all gates passed), so you can confirm success by the final line — no need to capture the exit code or redirect output to a log.

If you are an AI agent, prefer the quiet variants make lint-short and make verify-short. They run the exact same gates but suppress normal output to conserve your context window: on success they print only a banner (lint-short: all gates passed / verify-short: all gates passed), and on failure they print a short tail of the failing gate's output plus the full make <gate> target to re-run for complete diagnostics. Run that full target when you need to see everything. Do not hand-roll make lint >log 2>&1; echo $? pipelines — the short variants already do this correctly.