Project Workflow Suite

面向 Codex 与 Cursor 的项目交付插件，包含持久化多 Agent 编排、跨会话接力、验收证据管理，以及亚马逊软件需求澄清能力。

包含内容

project-workflow：任务依赖、文件占用、检查、独立审查、验收和 checkpoint。
amazon-requirements-discovery：把模糊的亚马逊运营软件需求整理成可批准、可验收的项目基线。
codebase-memory-mcp 集成说明：以本机独立安装的代码图谱服务进行结构发现和影响分析。

环境要求

Codex Desktop、提供 codex CLI 的 Codex 环境，或 Windows 版 Cursor。
Python 3.12 或更高版本。
独立安装的 codebase-memory-mcp。Cursor Windows 安装支持 PATH 和默认用户安装目录。

本插件的安装器不会下载或执行第三方脚本。请先按照 codebase-memory-mcp 项目说明完成依赖安装。

下载

在仓库右侧打开 Releases，下载 project-workflow-suite-0.3.0+codex.20260906.zip 和对应的 .sha256 文件。校验 SHA256 后解压，也可以直接克隆仓库：

git clone https://github.com/Yongli-Netizen/project-workflow-suite.git
cd project-workflow-suite

安装到 Codex

从 GitHub Releases 下载源码包并解压，或克隆仓库，然后在插件根目录执行：

.\scripts\install.ps1

macOS 或 Linux：

sh ./scripts/install.sh

安装器会把插件复制到用户目录下的独立 marketplace，不会修改已有的 personal marketplace。安装完成后重启 Codex，并新建任务加载插件。

安装到 Cursor（Windows）

在插件根目录执行：

.\scripts\install-cursor.ps1

安装器会复制插件到 %USERPROFILE%\.cursor\plugins\local\project-workflow-suite。完成后重启 Cursor，或执行 Developer: Reload Window，再到 Customize → Plugins 确认并启用。

Cursor 版本采用 Agent Plugins 1.0 标准清单，包含两个 Skill 和 codebase-memory-mcp 配置。当前随包安装器和 MCP 启动桥接仅验证了 Windows；macOS/Linux 用户请使用 Cursor 自定义 MCP 配置并确保 codebase-memory-mcp 位于 PATH。

使用

在 Codex 或 Cursor Agent 对话中调用：

$project-workflow
$amazon-requirements-discovery

插件不会自动获得发布、安装依赖或业务高风险操作权限。实际权限仍由 Codex 和用户授权控制。

更新

下载新版本并重新运行对应平台的安装脚本。Codex 安装器会更新独立 marketplace；Cursor 安装器会更新本地插件目录。

发布者检查

在 Windows 上生成可上传到 GitHub Releases 的 ZIP 和 SHA256 文件：

.\scripts\package.ps1

产物写入 release/。打包脚本会排除 Git 元数据、测试缓存、已有发布包和本地工作流账本。

发布前至少执行：

python .\skills\project-workflow\scripts\validate_skill.py
python -m unittest discover -s .\skills\project-workflow\tests -v
python -m unittest discover -s .\skills\amazon-requirements-discovery\tests -v

测试结果只证明本地功能检查通过，不代表真实业务环境或外部服务已验收。

许可证

MIT