{"repo":"AlanHuang168/AI-Project-Workflow","free":true,"listed":false,"github":"https://github.com/AlanHuang168/AI-Project-Workflow","clone":"git clone https://github.com/AlanHuang168/AI-Project-Workflow.git","description":"一套面向 Cursor、Claude Code、Codex、Qoder、CodeBuddy、CatPaw、TRAE 以及其他 AI 编码助手的通用 AI 原生软件交付工作流。一份规范的 core/ 单一真相源、每个工具一层轻量适配、一个跟踪进度的状态文件,以及负责安装与校验的 CLI。","language":"JavaScript","stars":25,"topics":["a-gen-t","ai","claude","cli","codex","cursor","prompt-engineering","sdd","workflow"],"license":"MIT","category":"workflow-automation","readme_excerpt":"AI Project Workflow English 一套面向 Cursor、Claude Code、Codex、Qoder、CodeBuddy、CatPaw、TRAE 以及其他 AI 编码助手的通用 AI 原生软件交付工作流。一份规范的 core/ 单一真相源、每个工具一层轻量适配、一个跟踪进度的状态文件,以及负责安装与校验的 CLI。 为什么需要它 当需求、架构、设计和测试还不清晰时,AI 编码助手就急着写代码。结果是:没人要的功能、悄悄扩大的范围,以及从未真正运行过的测试被报告成「全部通过」。 AI Project Workflow 把交付过程显式化: - 每个阶段都有 Skill 契约:前置条件、允许的改动、产出物、停止条件。 - 每个交付物都必须写入 docs/ 下的文件,禁止只在对话里打印。 - 进度记录在 .ai-workflow/state.json 中,逐阶段设门禁。 - 验证必须诚实报告:真正执行过的命令、真实结果、遗留风险。 工作原理 APW 将运行时文件收纳在 .ai-workflow/ 下,让项目根目录保持干净,同时继续兼容旧目录布局。 安装后,项目根目录只保留 AI 工具需要自动发现的入口文件。APW 自己的运行时、状态、版本和适配说明都会放进隐藏目录 .ai-workflow/ : 旧项目如果仍然使用根目录 core/ 或 VERSION ,也仍然有效:APW 会优先读取 .ai-workflow/ ,需要时再回退到旧目录布局。 约束是基于提示词的:适配层指示 AI 先读当前阶段的 Skill、核对上游文档、更新状态文件,然后才能推进。CLI 负责校验文件( apw validate 、 apw status );AI 遵守契约是因为每个入口都这样要求它。如果 AI 跑偏了,让它重新阅读 AGENTS.md 。 不会 Node.js、npm 或终端命令？ 查看零基础安装指南。 快速开始 或全局安装: 支持的平台: cursor 、 trae 、 qoder 、 codebuddy 、 catpaw 、 claude-code 、 codex 、 all 。 已验证平台 平台 状态 证据 ---- ---- ---- Cursor ✅ Verified Report Claude Code ✅ Verified Report Codex CLI ✅ Verified Report TRAE ✅ Verified Report CodeBuddy ✅ Verified Report CatPaw ✅ Verified Report Qoder ⏳ Pending Report 完整结果见 compatibility matrix。 Qoder 待验证：当前测试账号额度不足，尚未完成真实环境验证。 端到端:你的第一个项目 安装之后实际会发生什么——以在 Cursor 里做一个待办清单 Web 应用为例。 1. 把工作流装进新项目: todo-app/ 现在包含 AGENTS.md 、 CLAUDE.md 、 .cursor/ ,以及一个收纳全部 APW 内部实现的 .ai-workflow/ 目录(runtime、状态文件 currentStage: \"init\" 等)。项目根目录保持干净。 2. 启动第一个阶段。 在 Cursor 中打开 todo-app ,对 AI 说: .cursor/rules/ai-sdd.mdc 规则始终挂载,AI 会先读 .ai-workflow/runtime/skills/prd/SK","default_branch":null,"files":null,"tree":[],"storefront":"/r/AlanHuang168","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/AlanHuang168/AI-Project-Workflow/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}