Praxis

中文

English
日本語
한국어

中文

English
日本語
한국어

Appearance

Praxis定目标，不干预。

AI 编程智能体的工程规范框架。用目标和完成标准指导智能体，而不是步骤。

开始使用
在 GitHub 查看
PraxisPraxis

诊断驱动

每个任务在加载任何技能前都先诊断范围。微小的任务跳过整个流程 —— 没有必要的复杂度。

轻量

每个技能平均 230 token。完整的设计→交付流程约 1,300 token。与其他方案的 30-50k 相比。

目标驱动，不是指令驱动

规范是决策列表。计划是里程碑框架。智能体会带来领域知识 —— Praxis 提供验收标准。

跨工具

支持 Claude Code、Codex、OpenCode、Antigravity CLI、Gemini CLI、GitHub Copilot CLI，以及任何能读 markdown 的工具。

效果展示 ​

微小修复 ​

bash
你: 把 README 里的 "teh" 改成 "the"

praxis: scope=trivial
# 直接修改文件，完成。无需规范或计划。

标准功能 ​

bash
你: 添加 GitHub OAuth 登录

praxis: scope=standard, loading=design,plan,tdd,review

生成 docs/staging/specs/2025-06-02-github-oauth.md：

contract:  GET /auth/github → 跳转授权; /callback → 建立会话
invariant: 已有会话不受影响; 登出清除 cookie
test:      使用有效 GitHub App 凭证完成完整登录流程
deferred:  多平台 OAuth 支持

生成 docs/staging/plans/2025-06-02-github-oauth.md：

- [ ] T1: 接入 OAuth 中间件
  goal:       将 passport-github2 接入 Express 会话
  files:      src/auth/github.ts, src/middleware/session.ts
  acceptance: npm test -- --grep "OAuth"

- [ ] T2: 回调处理与会话持久化
  goal:       解析 GitHub 回调，写入并持久化用户会话
  files:      src/auth/callback.ts, src/models/user.ts
  acceptance: 登录后 GET /me 返回正确用户信息

并行迁移 ​

bash
你: 将整个 API 从 REST 迁移到 tRPC

praxis: scope=complex, loading=design,plan,worktree,subagents,review,ship

生成 docs/staging/plans/2025-06-02-rest-to-trpc.md：

[parallel] T1, T2, T3

- [ ] T1: 迁移 /users 路由
  goal:       将 users CRUD 替换为 tRPC procedures
  files:      src/routers/users.ts
  acceptance: npm test -- users

- [ ] T2: 迁移 /products 路由
  goal:       将产品查询迁移至 tRPC
  files:      src/routers/products.ts
  acceptance: npm test -- products

- [ ] T3: 迁移 /orders 路由
  goal:       将订单流程迁移至 tRPC，保留事务边界
  files:      src/routers/orders.ts
  acceptance: npm test -- orders

3 个子智能体并行推进，协调者负责最终审查与合并。

Released under the MIT License.