Community程式設計與開發github.com

代理技能維護

維護編碼代理指令及其發現路徑。用於建立或修改 AGENTS.md、CLAUDE.md、代理規則或指令投影時。確保在更改代理指引或其部署時使用此技能,即使請求只指定單一代理。

代理技能維護 是什麼?

此技能定義了一套嚴謹的流程,用於管理 AI 編碼代理(如 Claude Code、Codex)的指令文件及其發現與部署機制。其核心價值在於維護單一權威來源,避免指令重複與衝突,並透過強制性的步驟(如全面審查 `references/maintenance.md`、檢查現有階層、選擇單一來源、更新所有消費端)來確保一致性。技能特別提醒避免將條件式指引放入始終載入的指令中,因為這會浪費上下文,而應改用代理技能來實現漸進式揭露。此外,它也警示不同代理平台(如 Claude Markdown 規則 vs. Codex 命令規則)的語意差異,以及僅更新單一投影可能導致的行為不一致。這項技能適用於任何依賴指令文件的 AI 代理工具,幫助團隊建立可擴展、可維護的指令管理流程。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SebastienElet/agent-skills/tree/HEAD/skills/agent-instructions

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

代理指令維護

概述

保持代理指引範圍明確、易於發現,並源自單一權威來源。在更改指令內容、適配器、部署或驗證之前,套用共享的維護政策。

使用方式

使用此技能來修改全域或專案指令、代理專屬規則檔案,以及暴露這些規則的配置。例如:$agent-instructions add a Codex instruction source。

步驟

  1. 完整閱讀 references/maintenance.md。
  2. 檢查現有的指令階層,以及受此變更影響的每個發現路徑。
  3. 選擇一個權威來源,並將代理專屬位置保留為投影或適配器。
  4. 更新每個消費該來源的安裝器、生成的檔案、索引和驗證屏障。
  5. 獨立驗證每個受影響的代理投影。

注意事項

  • 在始終載入的指令中放入條件式指引 — 每個任務都要付出上下文成本;將其作為代理技能暴露給支援漸進式揭露的代理。
  • 將同名機制視為等效 — Claude Markdown 規則和 Codex 命令規則具有不同的語意;請驗證消費者的發現合約。
  • 僅更新一個投影 — 另一個代理會默默地保留過時的行為;請列舉每個已宣告的消費者,並測試其實際的部署目的地。

約束條件

  • 為共享的指令行為維護一個權威來源。
  • 絕不將條件式規則作為相容性墊片注入始終載入的指令檔案中。
  • 除非檢查過該投影的真實部署目的地,否則絕不報告其運作正常。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能