/g The Contract Codex ← 返回动态 Catalog

Repository Agent Instructions

Add repository-level agent instructions that document project structure, build/test/validate commands, coding standards, and documentation expectations.

难度:intermediate 分类:docs 来源:GitHub Copilot cloud agent best practices

完整 Prompt(可直接复制)

/goal
GOAL:
Complete Repository Agent Instructions for a developer-facing documentation site or repository: Add repository-level agent instructions that document project structure, build/test/validate commands, coding standards, and documentation expectations.

CONTEXT:
- Before editing, read the nearest AGENTS.md/CLAUDE.md, current issue or PLAN.md, and any failing logs already in the repo.
- Inspect README, docs, examples, runbooks, and lint configuration.
- Establish a baseline by running or locating evidence for: `.github/copilot-instructions.md or AGENTS.md present, commands verified, repository structure covered, standards documented`.

CONSTRAINTS:
- Keep the scope limited to this goal; do not expand into unrelated cleanup.
- Do not weaken tests, delete assertions, or mask errors to make verification pass.
- Respect the repository's AGENTS.md/CLAUDE.md instructions and existing patterns.
- Do not invent APIs, flags, commands, or product behavior.
- Mark unverified commands clearly instead of presenting guesses as facts.

DONE WHEN:
- The implementation or documentation directly satisfies: Add repository-level agent instructions that document project structure, build/test/validate commands, coding standards, and documentation expectations.
- The verification command or evidence path succeeds: `.github/copilot-instructions.md or AGENTS.md present, commands verified, repository structure covered, standards documented`.
- The final diff is scoped to the relevant files and has no unrelated formatting churn.

VERIFY:
- Run `.github/copilot-instructions.md or AGENTS.md present, commands verified, repository structure covered, standards documented` or the closest repo-local equivalent if the exact command is not available.
- Capture before/after evidence for the behavior, metric, report, or artifact involved.
- If verification cannot run locally, stop and report the missing dependency instead of guessing success.

OUTPUT:
- Summarize changed files, key decisions, verification output, and remaining risks.
- Include any follow-up that is required for production rollout or human review.

STOP RULES:
- Pause if secrets, production access, stakeholder decisions, or destructive data operations are required.
- Pause after three failed fix attempts on the same symptom and challenge the root-cause hypothesis.
- Do not mark the goal complete until the current repository state has been audited against DONE WHEN.

来源与证据

原始来源: GitHub Copilot cloud agent best practices

证据摘要: guide Copilot on how to understand your project and how to build, test and validate its changes; source: GitHub Copilot cloud agent best practices; type: official-agent-task; verification: .github/copilot-instructions.md or AGENTS.md present, commands verified, repository structure covered, standards documented