# Init Project Bootstrap > 当用户提及“代码仓初始化”“初始化代码仓”“初始化目录”“初始化项目结构”“初始化项目文档路径”“初始化 Codex 持续开发工作流”“初始化 antarx-harness 文档体系”或明确要求执行 `/init` 命令时触发；若同时提及 simple、lightweight、轻量、极简、轻量 harness、初始化轻量 harness、轻量化 agent 流程等表达，则使用轻量分支。用于在当前项目目录创建缺失的 AGENTS.md、ARCHITECTURE.md 与 docs 工作流骨架，必要时初始化 Git 仓库，并提交本次新增文档；若已有 AGENTS.md 与模板不同，必须由 agent 比对并合成为一份。 Use when this capability is needed. - Skill: `tomevault-io/init-project-bootstrap` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/init-project-bootstrap` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/init-project-bootstrap/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/init-project-bootstrap --- # Codex 持续开发工作流初始化 这个技能只初始化持续开发工作流骨架，不执行具体需求开发。 ## 分支选择 - 默认走全量初始化流程。 - 只有用户在初始化请求中明确提及 `simple`、`lightweight`、`轻量`、`极简`、`轻量 harness`、`初始化轻量 harness`、`轻量化 agent 流程` 等表达时，才走轻量初始化流程。 - 不要把拼写错误或无关近似词当作轻量分支触发词；分支选择必须能从用户原话中直接看出轻量意图。 ## 全量执行目标 - 在当前项目根目录创建以下结构，缺失才创建；除 `AGENTS.md` 外，已有必须 SKIP： - `AGENTS.md` - `ARCHITECTURE.md` - `docs/request-clarify/index.md` - `docs/design-docs/index.md` - `docs/design-docs/core-beliefs.md` - `docs/exec-plans/active/` - `docs/exec-plans/completed/` - `docs/exec-plans/tech-debt-tracker.md` - `docs/generated/` - `docs/product-specs/index.md` - `docs/references/` - `docs/DESIGN.md` - `docs/FRONTEND.md` - `docs/PROGRESS.md` - `docs/PRODUCT_SENSE.md` - `docs/QUALITY_SCORE.md` - `docs/RELIABILITY.md` - `docs/SECURITY.md` ## 轻量执行目标 - 在当前项目根目录创建以下结构，缺失才创建；除 `AGENTS.md` 外，已有必须 SKIP： - `AGENTS.md`，从 `assets-simple/AGENTS.simple.md` 复制而来。 - `docs/ARCHITECTURE.md` - `docs/PROGRESS.md` - `docs/requirements/index.md` - `docs/requirements/requirement-template.md` - 轻量流程使用 `REQ-NNNN` 形式的递增需求编号跟踪开发活动；创建新需求前必须检查 `docs/requirements/index.md` 和已有需求文件，使用当前最大编号加一。 - 单个需求的需求澄清、设计文档、开发计划、验证记录和验收记录必须放在同一个需求文件中。 - 轻量流程不创建全量流程中的 request-clarify、design-docs、exec-plans、product-specs、generated、references 等目录，除非用户另行要求。 ## 执行步骤 1. 读取并确认当前工作目录（项目根目录）。 2. 根据分支选择运行初始化脚本： - 全量流程：运行 `scripts/init_project_structure.sh`。 - 轻量流程：运行 `scripts/init_project_structure.sh --simple`。 3. 脚本内必须遵守： - 执行文件创建前检查当前目录 Git 状态；若当前目录不在 Git 仓库中，先执行 `git init`。 - 目录：使用 `mkdir -p`，天然幂等。 - 全量文件：从 `assets/` 中按相同相对路径复制模板。 - 轻量文件：从 `assets-simple/` 中复制模板，其中 `AGENTS.simple.md` 必须落到目标项目的 `AGENTS.md`。 - 普通文件仅在目标不存在时复制；若已存在则打印 `SKIP` 并保持原内容不变。 - `AGENTS.md` 若已存在且与所选模板内容不同，脚本只打印 `DIFF`，不改写、不追加、不合并。 - 禁止删除、重命名、覆盖现有文件。 - 初始化完成后只暂存并提交本次新建的 harness 文档文件，不提交目标项目中已有的其他改动。 - 若本次没有新建文件，不创建空提交。 - 初始化提交信息固定使用 `chore: initialize antarx harness docs`。 4. 若脚本输出 `DIFF AGENTS.md`，agent 必须执行合并： - 比对目标项目现有 `AGENTS.md` 与本次分支对应模板：全量用 `assets/AGENTS.md`，轻量用 `assets-simple/AGENTS.simple.md`。 - 保留现有 `AGENTS.md` 中的项目规则、安全规则、命令、路径和长期约束。 - 从模板中补入缺失的持续开发工作流、文档阅读顺序、产物落点、归档规则和子目录 `AGENTS.md` 规则。 - 把内容合成为一份自然可读的 `AGENTS.md`；不要机械追加完整模板块，不要留下重复章节。 - 若现有规则与模板规则冲突，优先保留更具体或更严格的项目规则；无法判断时停止并询问用户。 - 合并后用 `git diff -- AGENTS.md` 检查结果，只提交本次初始化相关的 `AGENTS.md` 合并改动。 5. 执行后输出简要结果： - 新建了哪些目录/文件 - 跳过了哪些已存在项 - 哪些文件存在差异并已由 agent 合并 - 是否初始化 Git 仓库，以及是否提交了新建文档 6. 输出只包含新建、跳过、差异合并和 Git 操作结果，不输出项目业务内容、需求分析、设计建议或开发计划。 ## 资产组织 - 全量模板文件放在 `assets/` 下，路径与目标项目内的落点保持一致。 - 轻量模板文件放在 `assets-simple/` 下，路径与目标项目内的落点保持一致；只有 `AGENTS.simple.md` 例外，它复制到目标项目根目录 `AGENTS.md`。 - 例如 `assets/AGENTS.md` 复制到项目根目录 `AGENTS.md`。 - 例如 `assets/docs/PROGRESS.md` 复制到项目内 `docs/PROGRESS.md`。 - 调整初始化模板时优先编辑 `assets/`，不要把长模板内联进脚本或 `SKILL.md`。 ## 约束 - 仅在用户明确要求初始化目录结构时执行。 - 任何情况下都不覆盖已存在文件内容；`AGENTS.md` 只能在 agent 比对后做人工合成式更新。 - 初始化产物不得包含具体项目业务内容。 - 初始化提交只能包含本次创建的 harness 文档文件，不能混入目标项目既有业务改动。 - 若遇到权限问题或路径异常，停止写入并反馈错误。 --- > Source: [gawainx/antarx-dev-skills](https://github.com/gawainx/antarx-dev-skills) — distributed by [TomeVault](https://tomevault.io).