codex-scrum-subagents
Use when work needs Scrum roles, ceremonies, backlog refinement, sprint planning, story delivery, release readiness, or role handoffs.
- License 许可
- MIT
- 最近更新
- 2026-07-15
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- codex-scrum-subagents
- description
- Use when work needs Scrum roles, ceremonies, backlog refinement, sprint planning, story delivery, release readiness, or role handoffs.
- load_priority
- on-demand
02 资源文件 40
- 参考文档agents/openai.yaml215 B
- 资产文件assets/artifact-templates/daily-scrum.md167 B
- 资产文件assets/artifact-templates/release-readiness.md194 B
- 资产文件assets/artifact-templates/retrospective.md150 B
- 资产文件assets/artifact-templates/sprint-goal.md172 B
- 资产文件assets/artifact-templates/story-delivery.md184 B
- 资产文件assets/artifact-templates/user-story.md158 B
- 资产文件assets/scrum-agent-kit/agents/backend-developer.md785 B
- 资产文件assets/scrum-agent-kit/agents/devops-engineer.md715 B
- 资产文件assets/scrum-agent-kit/agents/frontend-developer.md757 B
- 资产文件assets/scrum-agent-kit/agents/product-owner.md723 B
- 资产文件assets/scrum-agent-kit/agents/qa-engineer.md729 B
- 资产文件assets/scrum-agent-kit/agents/scrum-master.md734 B
- 资产文件assets/scrum-agent-kit/agents/scrum-orchestrator.md1.1 KB
- 资产文件assets/scrum-agent-kit/agents/security-engineer.md766 B
- 资产文件assets/scrum-agent-kit/agents/solution-architect.md724 B
- 资产文件assets/scrum-agent-kit/agents/ux-researcher.md797 B
- 资产文件assets/scrum-agent-kit/ARCHITECTURE.md2.0 KB
- 资产文件assets/scrum-agent-kit/README.md1.2 KB
- 资产文件assets/scrum-agent-kit/services/agents.json2.2 KB
- 资产文件assets/scrum-agent-kit/services/commands.json1.8 KB
- 资产文件assets/scrum-agent-kit/services/workflows.json751 B
- 资产文件assets/scrum-agent-kit/workflows/backlog-refinement.md3.2 KB
- 资产文件assets/scrum-agent-kit/workflows/daily-scrum.md2.2 KB
- 资产文件assets/scrum-agent-kit/workflows/release-readiness.md3.9 KB
- 资产文件assets/scrum-agent-kit/workflows/retrospective.md3.2 KB
- 资产文件assets/scrum-agent-kit/workflows/sprint-planning.md2.7 KB
- 资产文件assets/scrum-agent-kit/workflows/sprint-review.md2.6 KB
- 资产文件assets/scrum-agent-kit/workflows/story-delivery.md3.1 KB
- 参考文档references/artifact-templates.md1.3 KB
- 参考文档references/command-aliases.md1.9 KB
- 参考文档references/delivery-contracts.md1.9 KB
- 参考文档references/scrum-ceremonies.md2.7 KB
- 参考文档references/scrum-role-routing.md3.4 KB
- 参考文档references/subagent-boundaries.md2.2 KB
- 脚本scripts/_scrum_agent_kit.py22.0 KB
- 脚本scripts/generate_scrum_artifact.py4.2 KB
- 脚本scripts/install_scrum_subagents.py19.7 KB
- 脚本scripts/run_scrum_alias.py9.9 KB
- 脚本scripts/validate_scrum_agent_kit.py7.3 KB
03 SKILL.md 正文
TL;DR
Install .agent/ Scrum kit + .codex/agents/ native agents → use ceremony playbooks (sprint plan, daily scrum, retro, release) → enforce role boundaries between PO, SM, and delivery specialists.
Codex Scrum Subagents
Activation
- Activate when the user requests Scrum ceremonies or role-based workflows.
- Activate on explicit
$codex-scrum-subagentsor$scrum-install.
Overview
Materialize a project-local Scrum kit that adds two layers on top of the existing CodexAI skills:
.agent/for ceremony playbooks, role briefs, and workflow manifests.codex/agents/for native Codex custom-agent TOMLs that follow the official subagent discovery path
Use this skill when the team needs explicit role boundaries and delivery handoffs instead of a single monolithic assistant flow.
Quick Start
- Run
python scripts/install_scrum_subagents.py --help. - Install the bundled kit into the target project:
python scripts/install_scrum_subagents.py --target-root <project-root>
python scripts/install_scrum_subagents.py --target-root <project-root> --native-scope both
- Inspect differences before updating:
python scripts/install_scrum_subagents.py --target-root <project-root> --diff --format json
- Refresh only missing or changed files, with automatic backups for overwritten files:
python scripts/install_scrum_subagents.py --target-root <project-root> --update
- Validate either the bundled kit or an installed
.agenttree:
python scripts/validate_scrum_agent_kit.py --help
python scripts/validate_scrum_agent_kit.py
python scripts/validate_scrum_agent_kit.py --install-root <project-root>/.agent
python scripts/validate_scrum_agent_kit.py --target-root <project-root> --install-dir .meta/.agent --native-scope both
Command Aliases
Use references/command-aliases.md when the user wants a shorthand trigger instead of the raw Python entry point.
Common shortcuts:
$scrum-install: install the local.agentkit plus native.codex/agentsCodex custom agents$scrum-diff: compare installed.agentand.codex/agentsfiles against the source bundle$scrum-update: update only missing or changed files across both layers$scrum-validate: validate the bundle or installed.agentplus.codex/agentstree$story-ready-check,$sprint-plan,$daily-scrum,$story-delivery,$sprint-review,$retro,$release-readiness: jump straight to the ceremony or delivery workflowscripts/run_scrum_alias.py: execute an alias and optionally generate the mapped artifactscripts/generate_scrum_artifact.py: render reusable Scrum markdown artifacts from bundled templates- Workflow artifacts now require complete fields by default; use
--allow-placeholdersonly when you explicitly want a scaffold artifact with_TODO_markers.
What Gets Installed
agents/: Scrum core roles plus delivery specialists tuned for this pack.workflows/: ceremony-driven playbooks for refinement, planning, execution, review, retro, and release.services/: lightweight JSON manifests for docs tooling or UI surfaces.ARCHITECTURE.mdandREADME.md: onboarding docs for the installed.agentkit.assets/artifact-templates/: user story, sprint goal, daily scrum, retrospective, story delivery, and release readiness templates..codex/agents/*.toml: native Codex custom agents rendered from the Scrum role briefs so subagent activity can surface in the Codex app and CLI.
Role Routing
- Start with references/scrum-role-routing.md to choose the right subagent set for the request.
- Load references/scrum-ceremonies.md when the task is driven by a Scrum ceremony rather than a code change.
- Load references/command-aliases.md when the request uses shorthand commands like
$scrum-install,$story-ready-check, or$release-readiness. - Load references/artifact-templates.md when the workflow needs a repeatable markdown output instead of free-form notes.
- Load references/delivery-contracts.md when multiple roles need explicit artifact handoffs.
- Load references/subagent-boundaries.md before large orchestrations so responsibilities do not bleed across roles.
Installation Notes
- Default install targets are
<project-root>/.agentand<project-root>/.codex/agents. --native-scope project|personal|bothcontrols whether native Codex custom agents land in the project, the personal~/.codex/agentsfolder, or both.- Existing pack-managed files in either location block installation unless
--forceis supplied. --diffreports missing, changed, same, and extra files for both the.agentbundle and the native.codex/agentslayer.--updatecopies only missing or changed files across both layers and writes a fresh provenance stamp.- Validator supports both
--install-rootand the symmetric--target-root+--install-dirform so custom install directories stay aligned with native-agent validation. --backup-dirlets the caller choose where overwritten files are archived during update.- The installer writes
.codexai-scrum-kit.jsoninto the installed folder so the project can track provenance and bundle counts. - The installed subagents are designed to call back into existing skills like
codex-plan-writer,codex-domain-specialist,codex-security-specialist,codex-execution-quality-gate, andcodex-project-memoryinstead of duplicating that knowledge. - Restart Codex after installation if you want newly installed native custom agents to be picked up immediately by the app or CLI.
Guardrails
- Keep Product Owner focused on value, backlog, acceptance criteria, and sequencing.
- Keep Scrum Master facilitative; it owns flow and impediments, not solution details or scope decisions.
- Use delivery specialists only after backlog intent and sprint goal are explicit.
- Keep QA, security, and release checks attached to each story before marking it done.
04 同仓库更多 Skills
codex-test-driven-development
Fixture stub for TDD skill.
codex-subagent-execution
Fixture stub for subagent execution skill.
codex-runtime-hook
Fixture stub for runtime hook skill.
codex-plan-writer
Fixture stub for plan writer skill.
codex-execution-quality-gate
Fixture stub for quality gate skill.
codex-demo
Minimal fixture skill for Agency CLI skill-md parser tests.