Home

🧠 ai-coding-ok

AI 编程的 PDCA 记忆闭环。 superpowers 让一次对话变聪明，ai-coding-ok 让一个项目在 50 轮迭代中持续准确。

---

这是什么？

ai-coding-ok 是一个 AI 编程护栏框架。为任意项目安装三层记忆系统（project-memory + decisions-log + task-history），强制执行 PDCA（Plan → Do → Check → Act）闭环，确保 AI 在每次编码任务前后读取和更新项目记忆，解决"AI 修了 bug X 却搞坏了功能 Y"的问题。

支持平台： Claude Code · Codex · GitHub Copilot · Cursor · OpenCode

---

选择你的入口

🆕 我是新用户	🔄 我已经在用了	🔧 我要贡献
从这里开始，首次安装 ai-coding-ok	深入理解原理，学习高级用法	帮助改进 ai-coding-ok 本身
→ 快速上手	→ 使用指南	→ 贡献指南

---

快速上手

选择你的 AI 工具：

平台	安装指南	触发机制
Claude Code	Claude Code 安装	install.sh --claude-code 全局安装 skill
Codex	Codex 安装	install.sh --codex 全局安装 skill
GitHub Copilot	Copilot 安装	install.sh --copilot 复制模板到项目
Cursor	Cursor 安装	install.sh --cursor 复制模板到项目

安装后运行安装验证确认一切正常。

---

核心概念

概念	页面	你将学到
🔄 PDCA 工作流	PDCA 工作流	每次任务运行的 Plan→Do→Check→Act 循环
🧠 三层记忆	三层记忆系统	长期、中期、短期记忆文件
🎛️ 四种模式	四种模式 (A/B/C/D)	安装、规划、执行、升级——每种模式何时触发
🛡️ 五层防御	五层防御体系	v3.1+ 如何保证 PDCA 永不跳过

---

使用指南

主题	页面
日常开发流程	日常开发流程
为你的项目定制	定制化指南
升级到最新版	升级 ai-coding-ok
与 superpowers 组合	与 superpowers 组合
团队协作	团队最佳实践

---

架构

主题	页面
完整文件结构	文件结构
模板系统设计	模板系统
Claude Code Hooks 机制	Hooks 系统
版本管理与升级路径	版本管理
占位符系统	占位符系统

---

高级

主题	页面
编写自定义模板	自定义模板
CI 集成	CI 集成
多项目管理	多项目管理
故障排查	故障排查

---

参考

• FAQ — 常见问题，按主题分组
• Changelog — 版本历史与升级说明
• Contributing — 如何贡献

---

基本信息

许可证	MIT — 免费商用
最新版本	v4.1.0
依赖	零外部依赖（Shell + Python 3 标准库 + Markdown）
仓库	github.com/Mark7766/ai-coding-ok