AI Programming: Agent + Skill Workflow Framework — one .cataforge/ spec, many IDEs (Claude Code, Cursor, Codex, OpenCode).
Project description
CataForge
CataForge 把同一份 .cataforge/ 工作流规范部署到 Claude Code、Cursor、CodeX、OpenCode 四个 AI IDE,省去你为每个 IDE 重写 Agent / Skill / Hook / MCP 的工作。
60 秒跑通第一个部署
# 安装(推荐 uv tool)
uv tool install cataforge
# 在你的项目根目录下执行
cataforge bootstrap --platform cursor # 或 claude-code / codex / opencode
成功标志:终端最后一行打印 Diagnostics complete.。在对应 IDE 中打开项目即可使用。
先看不写盘:cataforge bootstrap --platform cursor --dry-run。
零安装试用:uvx cataforge bootstrap --platform cursor --dry-run。
其它安装方式(pip / 项目 venv / Windows 最小清单)见 安装指南。
它为你解决什么
| 问题 | CataForge 的做法 |
|---|---|
| 在 4 个 IDE 之间维护 4 套 Agent / Skill 定义 | 写一份 .cataforge/,cataforge deploy 翻译成各 IDE 的原生产物 |
| 某 IDE 不支持某个能力 | PlatformAdapter 按能力矩阵自动降级(rules_injection / prompt_check),而不是直接放弃 |
| 升级时怕覆盖手改的文件 | upgrade apply 前自动快照到 .cataforge/.backups/<ts>/,upgrade rollback 可回退 |
| 项目从零搭 SDLC 流程 | 内置 13 个 Agent + 26 个 Skill,覆盖需求 → 架构 → 设计 → TDD → 评审 |
下一步看哪里
| 你想…… | 去这里 |
|---|---|
| 5 分钟跑通第一个部署 | 快速开始 |
| 一页纸速查(平台 / CLI / 产物路径) | 速查卡 |
| 在你的 IDE 中真实落地 | 平台适配指南 |
| 端到端验证四平台 | 手动验证 |
| 升级到新版本 | 升级指南 |
| 查 CLI 命令参数 | CLI 参考 |
| 改配置 | 配置参考 |
| 定制 Agent / Skill | Agent & Skill 清单 |
| 理解内部如何工作 | 架构概览 |
| 解决报错 | 故障排查 · FAQ |
贡献 · License
- Issue 与 PR:见 CONTRIBUTING.md(开发环境、代码规范、测试基线、PR 约定、发布流程)
- 行为准则:CODE_OF_CONDUCT.md
- MIT License:LICENSE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cataforge-0.1.15.tar.gz.
File metadata
- Download URL: cataforge-0.1.15.tar.gz
- Upload date:
- Size: 482.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4d8c744ed2da7ae7cfdc02f51b03fae2e7b9586caf6e05ffd455b4d8242d7d11
|
|
| MD5 |
f743932a84f795f619e9de0921569633
|
|
| BLAKE2b-256 |
56ecbd7dc0c95d73416c8e06a24cdb6a5a462d1e703cf391d932662434a5f8aa
|
Provenance
The following attestation bundles were made for cataforge-0.1.15.tar.gz:
Publisher:
publish.yml on lync-cyber/CataForge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cataforge-0.1.15.tar.gz -
Subject digest:
4d8c744ed2da7ae7cfdc02f51b03fae2e7b9586caf6e05ffd455b4d8242d7d11 - Sigstore transparency entry: 1392679888
- Sigstore integration time:
-
Permalink:
lync-cyber/CataForge@9edbbe145aeee8b1d2f6b3a5295ed666d40c7b4e -
Branch / Tag:
refs/tags/v0.1.15 - Owner: https://github.com/lync-cyber
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9edbbe145aeee8b1d2f6b3a5295ed666d40c7b4e -
Trigger Event:
push
-
Statement type:
File details
Details for the file cataforge-0.1.15-py3-none-any.whl.
File metadata
- Download URL: cataforge-0.1.15-py3-none-any.whl
- Upload date:
- Size: 453.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
99fd86abff9a8bff06186e8aa4b81850a068ccbd5436a089daf8dc354e9e7040
|
|
| MD5 |
122281ad4ca3abd6b1fcb45344ebd56b
|
|
| BLAKE2b-256 |
5badbde9841a2b339485c42dffaed436b44116aa6622e004695366ea49483f4a
|
Provenance
The following attestation bundles were made for cataforge-0.1.15-py3-none-any.whl:
Publisher:
publish.yml on lync-cyber/CataForge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cataforge-0.1.15-py3-none-any.whl -
Subject digest:
99fd86abff9a8bff06186e8aa4b81850a068ccbd5436a089daf8dc354e9e7040 - Sigstore transparency entry: 1392679893
- Sigstore integration time:
-
Permalink:
lync-cyber/CataForge@9edbbe145aeee8b1d2f6b3a5295ed666d40c7b4e -
Branch / Tag:
refs/tags/v0.1.15 - Owner: https://github.com/lync-cyber
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9edbbe145aeee8b1d2f6b3a5295ed666d40c7b4e -
Trigger Event:
push
-
Statement type: