# Workflow (workflow.games)

> 面向团队的 AI游戏研发协作平台，用数据量化游戏研发:需求、缺陷、排期、追溯一体。
> 本文件是帮助中心的机器可读索引(generated by tools/help-site-build.mjs — do not edit)。

## 这是什么

- **做什么**:面向 AI游戏研发团队，把需求、缺陷、排期、验收放在一条可追溯的数据链上,用数据量化游戏研发。
- **给谁**:游戏研发团队(策划 / 程序 / 美术 / QA / 制作人),以及代表他们干活的 AI Agent。
- **三套内核**:需求与工作项(需求室、可配置工作流、验收闭环)、排期(甘特、依赖驱动的延期传播、里程碑)、追溯(变更集与领域事件)。
- **怎么接入**:能力一律 API-first —— 先有 OpenAPI 合同再有页面,所以 Agent 能做的事和人能做的事是同一套。
- **访问结构**:中央面 `workflow.games`(组织与项目管理),项目面 `<项目前缀>.workflow.games`(日常干活)。

## 建议的读取顺序

1. 本文件 —— 全站索引与事实卡。
2. [llms-full.txt](https://workflow.games/llms-full.txt) —— 全部指南正文的单文件语料,一次抓取即得完整文档。
3. [OpenAPI 3.1 合同](https://workflow.games/openapi/gameflow.v1.yaml) —— 要调 API 时读这份,它是 API 行为的单一真值。
4. [Agent 接入指引](https://workflow.games/wiki/agents) —— 鉴权口径与插件安装。
5. [更新日志 RSS](https://workflow.games/changelog.xml) —— 增量跟进,不必重抓全站。

## Agent 插件(推荐的接入方式)

- Claude Code:`/plugin marketplace add LumioGames/workflow-plugin` 然后 `/plugin install workflow@workflow-plugin`
- Codex:`curl -fsSL https://workflow.games/plugin/install.sh | bash`
- 公开分发仓:https://github.com/LumioGames/workflow-plugin
- 版本清单:https://workflow.games/plugin/version.json
- [安装指南](https://workflow.games/md/guides/agent-plugin.md) —— 双宿主的完整步骤与团队预装写法。

## 文档

- [文档首页](https://workflow.games/wiki)
- [Agent 接入指引](https://workflow.games/wiki/agents)
- [更新日志](https://workflow.games/wiki/changelog)(RSS: https://workflow.games/changelog.xml)
- [全文语料](https://workflow.games/llms-full.txt)(全部指南正文拼合)

## 使用指南(.md 源)

- [快速上手：从注册到第一个需求](https://workflow.games/md/guides/getting-started.md):注册账号、创建组织与项目、邀请成员，到建出第一条需求的完整路径
- [需求评审与流转](https://workflow.games/md/guides/requirement-transitions.md):需求从需求池到已完成的状态流转：谁能流转、哪些动作要填原因、如何回溯
- [状态流转与自定义工作流](https://workflow.games/md/guides/work-item-workflow.md):需求、缺陷、子需求各自在哪里改状态，按钮为什么是灰的，槽位认领，以及给项目配自己的工作流
- [缺陷提报、流转与关单](https://workflow.games/md/guides/bug-lifecycle.md):三个提报入口、严重程度与优先级的分工、关单结论四选一，以及缺陷为什么关不掉
- [排期依赖与甘特](https://workflow.games/md/guides/schedule-dependencies.md):给甘特上的条目建前后置依赖、理解延期传播，以及为什么改依赖不会自动改日期
- [里程碑](https://workflow.games/md/guides/milestones.md):用里程碑标记评审、集成、冻结、发布等关键节点，状态自动派生，不用手动维护
- [通知中心与飞书集成](https://workflow.games/md/guides/notifications-feishu.md):铃铛通知都有哪几类、怎么全部已读，以及飞书群机器人报缺陷、私聊提醒怎么配
- [安装 Agent 插件](https://workflow.games/md/guides/agent-plugin.md):给 Claude Code / Codex 一键装上 Workflow 技能包，Agent 自己完成接入、项目操作与安全反馈
- [成员与角色](https://workflow.games/md/guides/members-roles.md):项目权限的两套开关：治理权限与模块访问级别，以及部门标签、最后管理员保护
- [附件上传与安全下载](https://workflow.games/md/guides/attachments.md):了解可上传文件类型、大小限制、强制下载规则与常见报错

## API

- [OpenAPI 3.1 合同(单一真值)](https://workflow.games/openapi/gameflow.v1.yaml)
- [API 参考(网页版)](https://workflow.games/wiki/api)
- 鉴权:项目 API Token(`Authorization: Bearer wfp_…`),在项目设置 → API Token 签发;有效权限 = token scope ∩ 用户实时角色权限。

## 最近更新

- 2026-09-03 当前项目上下文按 Token 天花板投影模块权限
- 2026-07-26 鉴权面加固：四道机械守卫
- 2026-07-23 角色权限拆分：治理权限与模块访问级别
- 2026-07-09 里程碑与统一创建面板
- 2026-07-08 可配置工作流引擎接管状态流转