Codex Skill Flow Template

一个可独立托管到 GitHub 的 Codex 工作流模板仓库，用于给新项目快速安装以下能力：

• 项目级 AGENTS.md
• .ai/ 长期文档、规格和记忆目录
• 固定版本的 taskmaster
• 项目共享 skills：feature-design、project-wiki

默认面向支持计划工具的 Codex 环境；在 Codex 中，taskmaster 会同步 update_plan。如果迁移到其他 agent，需要提供等价的计划同步能力。

Environment Requirements

• Bash 入口：需要 bash，以及 sha256sum 或 shasum 中的至少一个校验工具
• PowerShell 入口：需要 PowerShell 5.1+ 或 7+；校验使用 Get-FileHash，不依赖额外 checksum 工具
• 目标项目目录：必须已存在，且当前用户对该目录有读写权限

What This Repo Installs

安装后，目标项目会得到：

<project-root>/
  AGENTS.md
  .ai/
    docs/
    specs/
    MEMORY.md
  .codex/
    skills/
      taskmaster/
      feature-design/
      project-wiki/

Quick Start

1. 克隆本仓库
2. 选择你的终端环境并执行安装脚本：

bash scripts/linux/install-into-project.sh /path/to/your-project

powershell -ExecutionPolicy Bypass -File scripts/windows/install-into-project.ps1 -TargetPath C:\path\to\your-project

3. 校验整个模板安装是否完整： 会同时检查 taskmaster 固定版本、共享 skills 内容，以及 .gitignore 片段是否完整。

bash scripts/linux/verify-template.sh /path/to/your-project

powershell -ExecutionPolicy Bypass -File scripts/windows/verify-template.ps1 -TargetPath C:\path\to\your-project

4. 如需只校验固定版本 taskmaster 是否完整：

bash scripts/linux/verify-taskmaster.sh /path/to/your-project

powershell -ExecutionPolicy Bypass -File scripts/windows/verify-taskmaster.ps1 -TargetPath C:\path\to\your-project

Maintainer Verification

维护模板仓库自身时，可直接校验仓库源目录：

bash scripts/linux/verify-repo.sh

powershell -ExecutionPolicy Bypass -File scripts/windows/verify-repo.ps1

Repository Layout

codex-skill-flow-template/
  AGENTS.md
  README.md
  .gitignore
  template/
    AGENTS.md
    .ai/
    .codex/skills/
  support/
    taskmaster-baseline.txt
    gitignore-markers/
      taskmaster.txt
    gitignore-snippets/
  scripts/
    linux/
      install-into-project.sh
      verify-repo.sh
      verify-template.sh
      verify-taskmaster.sh
    windows/
      install-into-project.ps1
      verify-repo.ps1
      verify-template.ps1
      verify-taskmaster.ps1

Fixed Baseline

• 项目内固定使用 taskmaster
• 该目录包含完整的 SKILL.md、assets/、VERSION.md、CHECKSUMS.sha256
• LITE 模式任务文件位于项目根目录：<Task Name> TO DO list.csv
• FULL 模式任务文件位于：.codex-tasks/<task-name>/TODO.csv
• 固定目录为：.codex/skills/taskmaster/

Notes

• taskmaster 的过程文件默认不提交
• 临时任务文件默认保留；只有在用户明确同意后才执行清理删除
• .ai/ 中只放长期资产，不放任务过程文件
• 重复安装产生的 .backup.* 文件默认会被写入目标项目 .gitignore
• Linux / Ubuntu / macOS 使用 scripts/linux/*.sh 入口
• Windows 用户使用 scripts/windows/*.ps1 入口，无需额外安装 sha256sum / shasum
• 如果你升级 vendored taskmaster，应同步更新：
  • template/.codex/skills/taskmaster/
  • support/taskmaster-baseline.txt
  • support/gitignore-markers/taskmaster.txt
  • scripts/linux/install-into-project.sh
  • scripts/linux/verify-repo.sh
  • scripts/linux/verify-template.sh
  • scripts/linux/verify-taskmaster.sh
  • scripts/windows/install-into-project.ps1
  • scripts/windows/verify-repo.ps1
  • scripts/windows/verify-template.ps1
  • scripts/windows/verify-taskmaster.ps1
  • 相关说明文档