| name | python-implementation-workflow |
| description | Wrapper workflow recipe for parent Codex sessions that need to coordinate Python topic delivery with repo-local planner, implementer, and reviewer agents while preserving shared artifact-contract boundaries. |
Python Implementation Workflow
當 parent Codex session 需要針對單一 topic 使用 repo-local Python implementation workflow,並完成 plan、implementation 與 review handoff 時,使用此 skill。
執行前請先閱讀 reference.md。
Role
此 skill 是提供給 parent Codex session 的 wrapper recipe。
- 它不會以自己的 engine 取代 runtime orchestration。
- 它不會重新定義屬於 custom agents 的核心 workflow contract。
- 它不會建立對 legacy
.github/agents/*.agent.md 檔案的 runtime dependency。
Required Inputs
- 單一 active topic 與其對應的 plan artifacts
- Repo-local custom agents:
planner
implementer
reviewer
- 當建立或審查 workflow artifacts 時,需使用共享的
workflow-artifact-contract skill
Wrapper Handoff Recipe
- 使用
planner 依據目前的 repo artifacts 確認或細化 topic execution plan。
- 使用
implementer 進行滿足已核准 plan 的 scoped repository changes。
- 使用
reviewer 檢查 correctness、path compliance、contract boundaries 與 validation coverage。
- 所有 workflow artifacts 只能保留在正式的 repo-local paths。
Required Returned Artifacts
planner 必須針對單一 active topic 回傳具體的 execution plan,包含 scoped steps、assumptions、constraints,以及 workflow 預期使用的 repo-local artifact paths。
implementer 必須回傳實際套用的 repository change set、精簡的 implementation summary,以及用來證明已執行核准 plan 的 validation results。
reviewer 必須回傳 review findings、residual risks 或 open questions,以及明確的 pass/fail recommendation,說明該 topic 是否可離開 review 階段。
- 回傳的 artifacts 必須建立在目前 repo-local workflow outputs 之上,且執行時不得依賴 legacy
.github/agents/*.agent.md 檔案。
- Legacy
.github/agents/*.agent.md 檔案僅作為 frozen provenance 保留,並非此 wrapper skill 所需的 runtime artifact source。
Required Gates
- Planning gate:
planner 必須先產出或確認可用的 topic plan,implementer 才能開始進行 scoped repository changes。
- Implementation gate:
implementer 必須維持在已核准的 topic scope 內,並在 handoff 給 reviewer 之前回傳已套用的 change summary 與 validation evidence。
- Review gate: 在 parent Codex session 將 topic 視為 review-complete 之前,
reviewer 必須驗證 correctness、path compliance、artifact-contract boundaries 與 validation coverage。
- Path gate: 所有 workflow artifacts 必須留在正式的 repo-local paths;此 wrapper skill 不可將 runtime artifacts 轉導到 legacy
.github/agents/*.agent.md 檔案或 repo-root agents/openai.yaml。
- Workflow boundary gate: git commit、push 與 pull request actions 仍屬於此 workflow 之外,不屬於滿足這些 gates 的一部分。
Human-Review Stop Boundary
- 一旦
reviewer 已針對 scoped topic 回傳 findings 與最終 pass/fail recommendation,parent Codex session 就必須停下來交由人工審查。
- 此 wrapper skill 會協調
planner、implementer 與 reviewer,但不得將自己呈現為可自行核准 release 或 merge 決策的 autonomous runtime orchestration engine。
- 若
reviewer 回報 blocking findings、unresolved risks 或 validation 不足,workflow 必須返回 parent Codex session,由人類明確指示下一步。
- 即使 review 通過,commit、push 與 pull request 的決策仍在此 workflow boundary 之外,必須由人類另行處理。
Boundaries
- Parent Codex session 仍負責 sequencing 與 tool execution。
- 此 skill 是提供給該 session 的描述性指引,不是獨立的 orchestrator。
- Git commit、push 與 pull request actions 仍在此 workflow skill 之外。