设置工作流程
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# setup-codex-agenticapps-workflow
This skill is the entry point for bootstrapping a fresh project with
the codex-workflow scaffolding. It applies the baseline migration
(`migrations/0000-baseline.md`) and any additional migrations that
have shipped between scaffolder versions, leaving the project at the
current scaffolder version.
## When to invoke
User asks to set up the workflow on a project that does not yet have
a `.codex/workflow-version.txt` file. The trigger skill's
`agentic-apps-workflow` does NOT auto-route to setup — setup is an
explicit, user-driven act because it modifies project-side files
(AGENTS.md, .planning/config.json, .codex/) that the user expects to
review.
## What this skill does
### Stage A — Pre-flight
1. **Verify Codex CLI.** `codex --version` must succeed.
2. **Verify scaffolder install.** Confirm
`${CODEX_HOME:-$HOME/.codex}/skills/agentic-apps-workflow/SKILL.md`
exists. If not, instruct the user to clone codex-workflow and run
`bash install.sh` from its root before retrying.
3. **Verify project state.**
- Project must be a git repo (`test -d .git`).
- Project must NOT already have `.codex/workflow-version.txt`. If
it does, route the user to `$update-codex-agenticapps-workflow`
and stop.
4. **Check optional gates.** Run the `optional_for` detection
commands from `0000-baseline.md` and record the user's choice for
each (e.g. Option A vs Option B install).
### Stage B — Gather placeholder values
5. **Ask the user** the questions in `0000-baseline.md` Step 1's
placeholder table:
- Project name
- Repo URL (autofilled from `git remote get-url origin` if
available; otherwise prompt)
- Client (internal / external name)
- Budget tier (free / paid / enterprise)
- Backend language (Go / Python / TypeScript / Rust / Other)
- Frontend stack (or "none" if backend-only)
- Database (or "none")
- LLM provider (anthropic / openai / google / other / none)
For optional values, accept defaults if the user says "default" or
skips:
- design-critique quality bar (default 90)
- impeccable-audit quality bar (default 90)
- QA viewports (default 1280, 390)
- DB blocking severity (default Critical, High)
### Stage C — Apply the baseline migration
6. **Walk `migrations/0000-baseline.md` step by step.** For each
step:
- Run the **idempotency check**. If it returns 0, log "skipped
(already applied)" and continue.
- Run the **pre-condition**. If it fails, error out with the
pre-condition's specific message.
- Show the user the **apply** block. In default-on-confirm
interactive mode, dry-run the whole chain first; in
`--no-confirm` mode, apply each step automatically.
- Apply the patch. For Step 1 (workflow-config.md), substitute
placeholders with the values from Stage B.
- On failure: prompt the user with retry / skip-with-warning /
rollback options per the atomicity contract in
`migrations/README.md`.
7. **Skip Step 6** (global AGENTS.md additions) if the user picked
Option B (per-project install) in Stage A's optional gate
detection.
### Stage D — Post-checks and commit
8. **Run all post-checks** from `0000-baseline.md`:
- `.codex/workflow-config.md` exists and has no unsubstituted
`{{...}}` placeholders
- `.planning/config.json` is valid JSON with the expected hook
keys
- `AGENTS.md` contains the `BEGIN: agentic-apps-workflow` marker
- `docs/decisions/README.md` exists
- `.codex/workflow-version.txt` reads `0.1.0`
9. **Atomic commit.** All baseline-migration changes go in a single
commit:
```bash
git add .codex/ .planning/ AGENTS.md docs/decisions/
git commit -m "chore: install codex-workflow v0.1.0"
```
10. **Surface follow-ups.** Tell the user:
- The project is now at `codex-workflow v0.1.0`
- Next step: run `$gsd-discuss-phase 1` to start a planning
session for the first phase
- Future scaffolder updates: run
`$update-codex-agenticapps-workflow` periodically; the skill
reads `.codex/workflow-version.txt` and applies pending
migrations
## Required evidence (per spec/06)
- `.codex/workflow-version.txt` exists with content `0.1.0`
- `.planning/config.json` is valid JSON with all `hooks` keys from
the template
- `AGENTS.md` contains the marker pair
`<!-- BEGIN: agentic-apps-workflow sections -->` ... `<!-- END: agentic-apps-workflow sections -->`
- `docs/decisions/README.md` exists
- The atomic commit is on the project's current branch with the
expected files staged
## Failure modes
- **Re-running on an installed project.** The pre-flight check
catches this; never auto-overwrite. Route to
`$update-codex-agenticapps-workflow`.
- **Scaffolder not installed.** Surface the install path; do not
silently skip steps that depend on the scaffolder.
- **Half-applied migration.** Per the atomicity contract, prompt
user (retry / skip / rollback). Do not auto-rollback without
consent — the user may prefer partial-state recovery.
- **Forgetting Step 6 distinction.** Option A (global) and Option B
(per-project) are mutually exclusive for this step. Skip Step 6
cleanly when the user picked Option B.
## Notes for the Codex host
- The default `$CODEX_HOME` is `~/.codex`. Migrations use the
`${CODEX_HOME:-$HOME/.codex}` form so users with a non-default
`$CODEX_HOME` get the same behavior.
- The `templates/` directory referenced from migrations lives at
`${CODEX_HOME:-$HOME/.codex}/skills/setup-codex-agenticapps-workflow/templates/`.
`install.sh` symlinks the scaffolder's top-level `templates/` to
this path so migrations can `cp` from a stable location.
- "Project name detection" can also pull from
`package.json::name`, `pyproject.toml::project.name`,
`Cargo.toml::package.name` — surface those as a prefilled
default in the question rather than always asking from scratch.
---
> Source: [agenticapps-eu/codex-workflow](https://github.com/agenticapps-eu/codex-workflow) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
章节与文件索引
按说明文件中的顺序排列。
何时调用
A 阶段 — 飞行前
阶段 B — 收集占位符值
阶段 C — 应用基线迁移
阶段 D — 事后检查和提交
文件/命令 -> migrations/0000-baseline.md · .codex/workflow-version.txt · agentic-apps-workflow · codex --version · ${CODEX_HOME:-$HOME/.codex}/skills/agentic-apps-workflow/SKILL.md · bash install.sh · test -d .git · $update-codex-agenticapps-workflow
内容校验值 -> f5f746389cc3
当前原文的自动摘译,尚未人工审校。
何时调用
用户要求在尚未建立的项目上设置工作流程
.codex/workflow-version.txt文件。触发技能的agentic-apps-workflow不会自动路由到 setup - setup 是一个显式的、用户驱动的行为,因为它修改用户期望的项目端文件(AGENTS.md、.planning/config.json、.codex/)A 阶段 — 飞行前
验证 Codex CLI。
codex --version必须成功。验证脚手架安装。确认${CODEX_HOME:-$HOME/.codex}/skills/agentic-apps-workflow/SKILL.md存在。如果没有,请指示用户克隆 codex-workflow 并运行bash install.sh在重试之前从其根开始。阶段 B — 收集占位符值
向用户询问以下问题
0000-baseline.md第 1 步的占位符表:项目名称 Repo URL(自动填充自git remote get-url origin如果有的话;否则提示)阶段 C — 应用基线迁移
步行
migrations/0000-baseline.md一步一步。对于每个步骤:运行幂等性检查。如果返回 0,则记录“已跳过(已应用)”并继续。运行前提条件。如果失败,则错误提示为阶段 D — 事后检查和提交
运行所有后检查
0000-baseline.md:.codex/workflow-config.md存在并且没有未被取代的{{...}}占位符.planning/config.json是具有预期挂钩键的有效 JSON