cataforge 0.1.12

AI Programming: Agent + Skill Workflow Framework — one .cataforge/ spec, many IDEs (Claude Code, Cursor, Codex, OpenCode).

CataForge

一份 .cataforge/ 规范，跨四个 AI IDE 一键落地。

---

功能亮点

• 写一次，处处运行 — Agent / Skill / Hook / MCP 的声明式规范，cataforge deploy 翻译为 Claude Code、Cursor、CodeX、OpenCode 各自的原生产物
• 不支持即降级 — PlatformAdapter 维护能力矩阵，能力缺失时优雅回退（rules_injection / prompt_check / skip），规范永远是唯一事实源
• 开箱即用的 SDLC — 内置 13 个 Agent、24 个 Skill，覆盖需求 → 架构 → 设计 → TDD → 评审全流程
• 升级可回滚 — cataforge upgrade apply 自动快照，upgrade rollback 一键回退；用户编辑的 runtime.platform、PROJECT-STATE.md 始终保留
• 元框架生成器 — workflow-framework-generator Skill 按工作流类型（软件开发 / 内容创作 / 研究分析…）与目标 IDE 生成一套新的 CataForge 兼容框架

---

快速开始

# 1. 安装（推荐 uv）
uv tool install cataforge

# 2. 一键跑通：setup → upgrade → deploy → doctor（每步按产物状态智能跳过）
cataforge bootstrap --platform cursor       # 或 claude-code / codex / opencode

看到 Diagnostics complete. 即成功。在对应 IDE 中打开项目即可使用。cataforge bootstrap --dry-run 可在写入前预览每步的 skip/run 决策。

零安装体验：uvx cataforge bootstrap --platform cursor --dry-run 直接临时运行，不全局装包。

想单步执行（setup / deploy / upgrade 各自独立可用），见 CLI 参考。

其它安装方式（pip / 项目 venv / Windows 最小清单）见 docs/getting-started/installation.md。

---

文档导航

我想……	去这里
5 分钟跑通第一个部署	快速开始
一页纸速查（平台 / CLI / 产物路径）	速查卡
在我的 IDE 中真实落地	平台适配指南 · 手动验证
升级到新版本 / 回滚	升级与脚手架刷新
查某个 CLI 命令	CLI 参考
改配置	配置参考
定制 Agent / Skill	Agent & Skill 清单
了解内部如何工作	架构概览
解决报错	FAQ · 故障排查

完整文档索引 →

---

贡献 · License

• 欢迎 Issue 与 PR。开发环境、代码规范、测试基线、发布流程见 CONTRIBUTING.md
• 社区行为准则：CODE_OF_CONDUCT.md
• MIT License — 详见 LICENSE