付録A:テンプレ集(AGENTS.md / Issue / PR / .agent.md / Skills)

本文で参照するテンプレート類の一覧と用途を整理します。

Companion repo

テンプレ一覧(初期)

AgentOps 運用(Issue→PR→反復)

  • エージェント指示: AGENTS.md
  • Issue(実行仕様): .github/ISSUE_TEMPLATE/agent-task.yml
  • バグ: .github/ISSUE_TEMPLATE/bug-report.yml
  • 改善: .github/ISSUE_TEMPLATE/improvement.yml
  • 依存更新: .github/ISSUE_TEMPLATE/dependency-update.yml
  • ドキュメント: .github/ISSUE_TEMPLATE/documentation.yml
  • PR: .github/PULL_REQUEST_TEMPLATE.md

権限/承認(ガバナンス)

  • CODEOWNERS 指針: CODEOWNERS_GUIDE.md

Skills(反復タスクの Runbook)

  • 依存更新: skills/dependency-update/SKILL.md
  • テスト追加: skills/add-tests/SKILL.md
  • ドキュメント整備: skills/docs-update/SKILL.md
  • 安全なリファクタ: skills/refactor-safe/SKILL.md

カスタムエージェント(役割特化)

  • doc-agent: custom-agents/doc-agent/.agent.md
  • test-agent: custom-agents/test-agent/.agent.md
  • dep-agent: custom-agents/dep-agent/.agent.md
  • MCP 公開範囲設計例: custom-agents/MCP_SCOPE_EXAMPLE.md

Rules(実行境界)

  • allow/prompt/forbidden のポリシー雛形: rules/command-policy.md

Codex Action(CI 統合)

  • PR 要約 + リスク抽出コメント: .github/workflows/codex-pr-review.yml
  • リリース前チェック(手動実行): .github/workflows/codex-release-prep.yml
  • プロンプト雛形: .github/codex/prompts/

1対1対応(固定パス前提)

本書は Companion repo の 固定パス を参照します。 運用上は「破壊的変更(移動/改名)」を避け、必要な場合は移行期間を設けてください。