coding-workflow-toolkit-project-skill-discovery

KO | EN

gitlite — search

#python #hacktoberfest #typescript #android #rust #deep-learning #macos #java #windows #vue #security #mcp #ios #openai

coding-workflow-toolkit-project-skill-discovery

(★ 39)

代码工作流引导工具

coding-workflow-toolkit-project-skill-discovery 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AI 辅助交付工作流

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

![AI 辅助交付工作流](https://raw.githubusercontent.com/wjyzhixing/coding-workflow-toolkit-project-skill-discovery/main/docs/assets/delivery-workflow.svg)

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

## 项目结构

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

```text
.
├── .agents/
│   └── skills/                       # Codex 可发现的 skill 镜像及元数据
├── .gitignore
├── AGENTS.md                         # 项目级工作流与协作约定
├── README.md
├── coding-workflow.md                # 可复用的 AI 辅助交付流程
├── docs/
│   └── assets/
│       └── delivery-workflow.svg
├── openspec/                         # 可选，由 delivery-report 在判断值得沉淀时生成
│   ├── specs/                        # 长期能力规格
│   └── changes/                      # 变更提案
├── examples/
│   ├── openspec-sediment-demo.md
│   └── 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/`](server/) 是一个可独立运行的 Fastify + TypeScript API 起点，提供统一 JSON 响应格式：

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

启动开发服务：

```bash
cd server
npm install
npm run dev
```

常用命令：

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

## 通过 npx skills 安装

仓库已发布到 GitHub，可以使用 [`skills`](https://skills.sh/) CLI 安装到支持 skills 的 AI 编程工具中。

安装全部工作流 skills：

```bash
npx skills add wjyzhixing/coding-workflow-toolkit-project-skill-discovery
```

只安装指定 skill：

```bash
npx skills add wjyzhixing/coding-workflow-toolkit-project-skill-discovery \
  --skill guided-delivery
```

指定安装目标：

```bash
# 安装到 Codex
npx skills add wjyzhixing/coding-workflow-toolkit-project-skill-discovery -a codex

# 安装到 Claude Code
npx skills add wjyzhixing/coding-workflow-toolkit-project-skill-discovery -a claude-code
```

安装完成后，重新打开或重启对应的 AI 编程工具，然后在任务中显式调用 skill，例如：

```text
$guided-delivery

我需要在 30 分钟内交付一个 React + Node.js 的最小功能。
```

更新已安装的 skills：

```bash
npx skills update
```

查看已安装的 skills：

```bash
npx skills list
```

## 两种使用方式

### 在本仓库中使用

`AGENTS.md` 是项目级默认指令：进入本仓库的 Codex 会先读取工作流，并按任务选择 `skills/` 中的对应流程。完整提示词和 30 分钟节奏见 [coding-workflow.md](coding-workflow.md)。

### 在任意仓库中调用 `$skill`

将 skills 安装到 Codex 或 Claude Code 的全局发现目录：

```bash
./install-codex.sh      # 安装到 ~/.codex/skills
./install-claude.sh     # 安装到 ~/.claude/skills
```

也可以指定自己的 skills 目录：

```bash
./install-codex.sh /path/to/skills
./install-claude.sh /path/to/skills
```

安装脚本不会联网或安装依赖。若目标已有同名 skill，会先创建带时间戳的备份，再复制新版本。

安装后，重启或新开 Codex 会话。完整任务优先显式调用：

```text
$guided-delivery

我需要在 30 分钟内交付一个 React + Node.js 的最小功能。
```

它会一次只问一个影响设计的问题，并给出推荐答案；形成目标路径、范围、API/状态、边界、验收测试与计划的共识记录后，等待你输入“确认实施”，才会写代码。

可用 skills：

- `$guided-delivery`：完整入口；一问一答达成共识，确认后实施、验证和审查。
- `$mvp-delivery`：将模糊需求收敛为可验证的最小交付。
- `$feature-slice`：在已有代码库中实现一条最小端到端功能。
- `$engineering-review`：按风险优先级审查当前变更。
- `$debug-loop`：基于证据定位问题、最小修复并回归验证。
- `$delivery-report`：伴随全流程记录关键事实，并输出需求、功能、问题或笔试题报告。

## 长期规格沉淀

`delivery-report` 在生成交付报告时判断本任务是否值得沉淀为 OpenSpec 风格的长期规格（跨任务复用的契约、反复出现的问题、团队共识载体等信号）。有信号时向用户推荐，确认后在项目根的 `openspec/` 目录写入 `specs/<capability>/spec.md` 与 `changes/<YYYY-MM-DD>-<slug>/proposal.md`。无信号或未确认则跳过，单次任务零额外噪音。不依赖 openspec CLI，未来可平滑迁移。

## 排序题示例

```text
$guided-delivery

题目要求实现“复杂度尽可能低”的排序，语言是 TypeScript，限时 30 分钟。先不要写代码。

请先判断“最低复杂度”是指时间、空间、稳定性还是特定输入约束；一次只问一个关键问题并给出推荐答案。说明比较排序的通用时间下界，并列出数据类型、取值范围、负数、重复值、数据规模、原地排序和稳定性这些必须确认的边界。

形成共识记录后，等待我输入“确认实施”再写代码。
```

如果题目未给出整数范围等特殊约束，通用比较排序无法优于 `O(n log n)`；不要把计数排序或基数排序当成无条件更优的答案。

## 完整对话示例

- [Scheduler 的 `$guided-delivery` 对话演示](examples/scheduler-guided-delivery-demo.md)
- [长期规格沉淀的 `$guided-delivery` 尾部演示](examples/openspec-sediment-demo.md)

coding-workflow-toolkit-project-skill-discovery

coding-workflow-toolkit-project-skill-discovery 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

coding-workflow-toolkit-project-skill-discovery

coding-workflow-toolkit-project-skill-discovery 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README