Skip to content

AGENTS.md

Latest commit

 

History

History
77 lines (54 loc) · 3.53 KB

AGENTS.md

File metadata and controls

77 lines (54 loc) · 3.53 KB
Raw

Spectra Instructions

This project uses Spectra for Spec-Driven Development(SDD). Specs live in openspec/specs/, change proposals in openspec/changes/.

Use $spectra-* skills when:

  • A discussion needs structure before coding → $spectra-discuss
  • User wants to plan, propose, or design a change → $spectra-propose
  • Tasks are ready to implement → $spectra-apply
  • There's an in-progress change to continue → $spectra-ingest
  • User asks about specs or how something works → $spectra-ask
  • Implementation is done → $spectra-archive
  • Commit only files related to a specific change → $spectra-commit

Workflow

discuss? → propose → apply ⇄ ingest → archive

  • discuss is optional — skip if requirements are clear
  • Requirements change mid-work? ingest → resume apply

Parked Changes

Changes can be parked（暫存）— temporarily moved out of openspec/changes/. Parked changes won't appear in spectra list but can be found with spectra list --parked. To restore: spectra unpark <name>. The $spectra-apply and $spectra-ingest skills handle parked changes automatically.

codex-pro Skills（Codex）

本 repo 的 skill 同時以兩種格式存在：

格式 路徑 叫用
Claude Code plugin plugins/codex-pro/skills/<name>/SKILL.md /codex-pro:<name>
Codex（本檔適用） .codex/skills/<name>/SKILL.md $<name>

.codex/ 那份由 scripts/generate-codex-skills.sh 從 plugin 版單向生成， 漂移由 tests/codex-skills-parity.sh 擋下。不要手改 .codex/skills/ 下的檔案 —— 改來源後重跑生成腳本。

可用 skill

Skill 用途
$codex-setup 驗證 OAuth、codex-call runtime 是否就緒。先跑這個
$codex-status 掃 .codex-pro/*.md 輸出結果摘要表（read-only、最輕量）
$codex-result 顯示特定 result 檔（frontmatter + body verbatim）
$codex-review 對 uncommitted diff / file / branch 跑 read-only review
$codex-adversarial-review 對設計或 code 跑 hostile challenge（找盲點，非找 bug）
$codex-rescue 把單一任務委派給 Codex
$codex-batch 平行批次處理大型 reference doc
$codex-config 顯示解析後的 profile（model / effort / max_time）
$codex-cancel Informational only — 目前為 stateless single-shot

⚠️ 執行前提

部分 skill 依賴 bin/codex-call，而該執行檔目前經由 parallel-ai-agents 這個 Claude Code plugin 分發。沒有安裝 Claude Code 的機器上不存在該檔案。

需要 codex-call 才能執行 不需要（純本機讀取）
$codex-review、$codex-adversarial-review、$codex-rescue、$codex-batch $codex-status、$codex-result、$codex-config、$codex-cancel

$codex-setup 兩者皆非：它的工作就是檢查 codex-call 在不在，缺檔時正常 回報 ✗ 而不是失敗 —— 所以在沒有 codex-call 的機器上它照樣能跑，也是該先跑的那個。

右欄那四個只讀 .codex-pro/*.md，沒有 codex-call 也完全可用。左欄那四個會叫得 出來但執行失敗。

獨立取得路徑尚未提供，追蹤於 #9 第 2 項與 parallel-ai-agents#35。