为什么值得关注

它提供了一种基于skill的结构化AI辅助交付方法，可安装到Codex和Claude Code等流行AI编码工具中，采用不写入代码的安全策略，并包含具体的示例和模板。

适合谁使用

使用AI编码助手的开发者
采用结构化AI工作流的团队
在时间限制下工作的个人开发者
练习交付技能的技术面试候选人

典型使用场景

快速原型化最小可行功能
基于证据定位生产问题
对当前变更进行工程审查
在已有代码库中实现一个小功能切片

项目优势

透明流程，记录关键决策、实际改动和验证证据
设计安全：从不执行commit、push或远程写操作
易于安装到Codex/Claude Code，并自动备份已有skill
包含React、Vue和Fastify API的即用模板

使用前须知

需要用户已安装Codex或Claude Code
工作流有一定的意见性，可能不适合所有团队文化
故意不支持远程写操作，限制了与CI/CD的完全集成

README 快速开始

AI 辅助交付工作流

一套面向日常开发、限时编码和产品技术讨论的透明工作流。它帮助你更快完成“澄清 → 决策 → 实现 → 验证”，但不会替你做关键判断。

$delivery-report 作为伴随 skill 记录关键决策、实际改动、验证证据与风险，并在结束时按任务类型生成中文报告。整个工作流不会执行 commit、push、PR 或远端写操作。

项目结构

以下结构基于当前工作区生成，省略 .git/、node_modules/ 与 dist/：

.
├── .agents/
│   └── skills/                       # Codex 可发现的 skill 镜像及元数据
├── .gitignore
├── AGENTS.md                         # 项目级工作流与协作约定
├── README.md
├── coding-workflow.md                # 可复用的 AI 辅助交付流程
├── docs/
│   └── assets/
│       └── delivery-workflow.svg
├── examples/
│   └── scheduler-guided-delivery-demo.md
├── install-codex.sh                   # 安装 skills 到 Codex (~/.codex/skills)
├── install-claude.sh                  # 安装 skills 到 Claude Code (~/.claude/skills)
├── install-common.sh                  # 安装脚本共享逻辑（被上面两个 source）
├── react/                             # React + Vite 示例
│   ├── src/
│   │   ├── test/setup.ts
│   │   ├── App.test.tsx
│   │   ├── App.tsx
│   │   ├── App.css
│   │   ├── index.css
│   │   └── main.tsx
│   ├── index.html
│   ├── package.json
│   ├── pnpm-lock.yaml
│   ├── tsconfig.app.json
│   ├── tsconfig.json
│   ├── tsconfig.node.json
│   └── vite.config.ts
├── server/                            # 独立 Fastify + TypeScript API 模板
│   ├── src/
│   │   ├── app.ts                     # 路由与统一错误处理
│   │   └── index.ts                   # 服务启动入口
│   ├── test/
│   │   └── app.test.ts                # API 契约测试
│   ├── package.json
│   ├── package-lock.json
│   └── tsconfig.json
├── skills/                            # 工作流 skill 源码
│   ├── debug-loop/
│   ├── delivery-report/
│   ├── engineering-review/
│   ├── feature-slice/
│   ├── guided-delivery/
│   └── mvp-delivery/
├── test.md
└── vue/                               # Vue + Vite 示例
    ├── src/
    │   ├── App.spec.ts
    │   ├── App.vue
    │   ├── App.css
    │   ├── index.css
    │   └── main.ts
    ├── index.html
    ├── package.json
    ├── pnpm-lock.yaml
    ├── tsconfig.app.json
    ├── tsconfig.json
    ├── tsconfig.node.json
    └── vite.config.ts

极简 Node API 模板

server/ 是一个可独立运行的 Fastify + TypeScript API 起点，提供统一 JSON 响应格式：

GET /health：服务健康状态；
GET /api/v1/hello：示例业务接口；
其他路径：统一 JSON 404 响应。

启动开发服务：

cd server
npm install
npm run dev

常用命令：

npm test        # 运行 API 契约测试
npm run build   # 编译到 dist/
npm start       # 启动编译产物

两种使用方式

在本仓库中使用

项目描述

代码工作流引导工具

coding-workflow-toolkit-project-skill-discovery