Praxis

一套给「AI 驱动开发」立规矩的通用 Agent Skills 方法论库。
让 AI 写代码又快又不失控——文档不漂移、评审不走过场、大任务不越界、施工范围不失控。

这是什么

Praxis 是一组按 .agents 约定组织、可供支持 Agent Skills 的工具使用的 skill（技能）。
每个 skill 是一份 AI 自动加载、照着执行的工作流规范。它们覆盖 AI 辅助开发的全链路：
反推文档、分层治理、设计、施工、测试、评审、自主执行、任务编排、Git 流程。

为什么需要它？ AI 写代码很快，但默认状态下也很「野」：

• 改了代码不同步文档 → 文档和现实漂移，越攒越不可信
• 让 AI「评审一下」→ 它既当运动员又当裁判，走过场；而认真评起来又停不下，一轮加一轮没完没了
• 丢一个大任务给 AI → 它越界乱改、上下文一满就失忆
• 不画图纸直接写 → 施工范围失控，改一处崩一片
• AI 自己写测试、自己判通过 → 跑不过就把断言改松，测试全绿而业务语义一个没验
• 让它一口气跑完长任务 → 要么每十分钟被打断，要么跑飞了没人拦

Praxis 把这些痛点逐个收成可执行的 skill——把「该有的纪律」固化进流程，而不是靠每次提醒。

核心理念：通用引擎 + 项目补丁

所有 skill 都是项目无关的通用引擎——只含方法论与规则，不硬编码任何具体项目的路径、
业务域、审查人。项目独有的值通过你自己的项目级补丁注入（见
templates/项目级补丁模板/）。

Praxis 的 skill（通用引擎，留白挂载点）
        ↑ 挂载
你项目的补丁 skill（填上你的路径/域/死亡线/审查人）

这样同一套引擎能服务任何项目，而你的项目隐私永远留在你自己仓库里。

🐎 三驾马车（Core Trio）

整个库的脊梁是这三套，串起来就是 AI 驱动开发的「规划 → 治理 → 把关」闭环：

1. 总控 · task-control-doc + control
   先把跨多次会话的大任务拆成自包含工作包（图纸），再让 AI 严格逐格施工：一次只动一个子任务、做完即停、绝不越界。AI 上下文再满不失忆、范围再大不跑偏。
2. 七层文档 · doc-layer-system —— 项目招牌
   给代码与文档建立分层治理，让两者永不脱节；死亡线区域强制真人把关。
3. 对抗评审 · adversarial-review
   触发时由用户选本机可用桥接和模型，至少一名评审者独立调查，主线程逐条裁决。同一对象只开放一次，整改转封闭验收——既防评审走过场，也防评审无限加码。

只想先试一个？从 总控 开始。

想让 AI 一口气把活干完？

如果你的目标不是"逐道工序审"，而是"交出去、它自己跑到底，只保留起点批准与终点验收"，
那就是另一条链路——从规格冻结到自主执行的结果管控闭环：

lightweight-design  设计决策钉死
        ↓
test-standards → test-case-design   用例先于施工冻结（断言编号 + 哈希锚）
        ↓
goal-charter  写执行契约（目标 + 验证器 + 边界 + 自愈清单）→ 按风险评审 → 授权角色批准
        ↓
自主执行 ──→ test-execution-router  跑测试、收证据、失败分类
        ↓
候选终审（由项目指定角色负责）

配套两道安全阀：deep-research-gate 管住扇出别烧穿配额，
codex-review 提供事后的低成本符合性核验。

单会话能做完的小任务不必走完整链路——plan-goal 是它的微缩档：
一份计划文件包住决策点、AC 表、章程，由业务决策负责人批准、指定候选验收人验收；个人项目可由一人兼任，团队项目可职责分离。

Praxis 不把“当前交互方”默认视为全部权限的持有人。任务发起、业务裁决、共享环境使用、发布授权和候选验收是不同治理角色；共享环境的租约、失效与抢占规则也由项目补丁声明，启动任务本身不构成环境授权。

安装

把 skills/ 下你需要的目录拷进用户级 skill 目录：

# 全部安装
cp -R skills/* ~/.agents/skills/

# 或只装你要的
cp -R skills/adversarial-review ~/.agents/skills/

同级目录很重要：部分 skill 之间有引用（如评审整改验收会回落到对抗评审、测试执行会回落到测试规范），
安装时保持它们在 ~/.agents/skills/ 下平级即可。

依赖：多数 skill 只需当前 Agent 工具。ask-codex 与 codex-review 需要 Codex CLI。adversarial-review 在触发时检查本机 Claude Code、Cursor Agent 与 Codex CLI，由用户从实际可用模型中选择；未安装的桥接不会阻止其他桥接使用。

Skill 总表

点击 skill 名跳转到该 skill 的「手把手」详解文档。

📐 文档体系

🔍 冷启动 / 反推

✏️ 设计 / 施工

🎯 自主执行

🧪 测试

⚖️ 评审

🎨 呈现 / 可视化

🗣 裁决交互

📨 派活问询

🧭 任务编排

🔧 Git 流程

升级 / 变更日志

已经装过旧版本？升级前先看 CHANGELOG.md——v2.0.0 含破坏性变更
（删除了 3 个 skill、对抗评审取消独立裁判轮、轻量设计从「事后回补」改为「事前物化」）。

贡献

欢迎补充新 skill。为保持全库格式统一（skill 结构、文档四段式、脱敏纪律），
请先读 CONTRIBUTING.md（规范真值源在 AGENTS.md）。

协议

Apache License 2.0。随便用、随便改、可商用，保留版权与变更声明即可。