或者说

AI-原生发展,定型. 你的经纪人在编辑前会读到规则,而门在忽略规则时会捕捉到.

[注] 你是经纪人吗? 读取 llms.txt 而不是这个页面.

它带有为机器写成的相同的设置:精确的命令,精确路径,以及对每次失败的决定表. 人类应该继续在这里.

为何存在或存在

你的经纪人读你的公约。 然后写随所喜. 没有检查.

两者兼有:

• 规则 ——代理在编辑前读取.
• 盖茨 ——脚本被接入了被忽略规则时会失败的git钩.

规则来源于gstack和gbrain,然后被硬化 超过500+ 合并拉运请求 代理任务。 。 。 .

你不同意的,你自己的 AGENTS.md 赢了.

与克洛德代码,Codex,OpenCode,和Amp合作.

0.28:无遥测,更瘦光谱

或者收集不使用遥测,以及 orly skill-event 财务报告和审定财务报表 orly lifecycle 不见了. 光谱模板是一个骨架,其评论引用了光谱标准中的规则. 每个维度都带有其测试层次和结果,基线来自基数的连续集成运行.

docs.language 现在报告在已更改的光谱行上留下的模板槽. 仍然带有已退休者的配置 execution 键被拒绝.

0.26:规则成为标准

规则现在以标准为标准: 短页的规则块 应用,检查,坏,好和为什么. 三项技能包括: orly-spec, (中文(简体) ), orly-build 财务报告和审定财务报表 orly-ship。 。 。 . 这个 orly-standards-reviewer 代理检查一个diff 违反标准 在拉请求之前.

永远 AGENTS.md 低于16KiB,低于37KB. 发送页面、审计脚本、读取门和 orly judge 不见了. orly gate pr 检查代码和 Git; 在写入时审查一个 spec .

orly doctor 检查每个代理运行时间都有gstack和"大象-金鱼"模型(EGM),无论您运行哪个版本. 代码云任务得到相同的设置; 参见 架构页面。 。 。 .

见 释放 用于出版版本. 下面的安装命令获取已公布的软件包 . 发布工作流程在版本更改后发布0.28.0 main 或明确发布运行.

先决条件

[大 永远不要复制钩子 每个队友都跑 orly init 一次在他们自己的退票, 即使在规则被承诺.

安装已发布的软件包

在您想要管理的仓库内运行此程序 .

bunx --bun @agentsfleet/orly init

或扫描您的源,检测您的语言,并安装只应用的规则.

[TIP] 尝试 bunx --bun @agentsfleet/orly init --dry-run 先说 它预览了生成的规则并更改了任何内容.

完成任何设置项目 init运行 bunx --bun @agentsfleet/orly doctor 并输入生成的文件. 使用 bunx --bun @agentsfleet/orly <COMMAND> 以下命令; <COMMAND> 命名命令及其选项. 已生成 Git 钩子引用被绑的套件通过 bunx; Bun 必须在钩子搜索路径上. 无需全面安装或依赖项目.

队友们拿到克隆的规则就跑 orly init 安装他们的钩子.

声明 conform 至少一个 verify.* 命令在 .orly/orly.json。 。 。 . Orly 运行您的寄存器命令; 校验名称不需要特定语言或测试跑取符 . Makefile提供的文件存储器 test 财务报告和审定财务报表 lint数字 :

"commands": {
  "conform": [["make", "test"]],
  "verify.docs": [["make", "lint"]]
}

给 test 检查工作期间的文件,以及 lint 在拉请求前验证站点和链接. Markdown和Markdown JSX(MDX)寄存器不需要应用单元或集成套件. orly doctor 检查配置和已安装的文件; 运行门以验证命令本身.

每次援引都有30分钟的最后期限和64米比特综合产出预算. 超过任意一个限制都会失败检查,停止其子进程并打印出一个私有输出接收路径. 设定每个命令的覆盖 .orly/orly.json,例如:

"limits": {
  "verify.unit": { "timeout_ms": 1800000, "output_bytes": 67108864 }
}

该收件保留了全部被捕获的输出,直到您删除其打印目录为止 . 拒绝未知的设置和错误的值; schemas/profile.schema.json 描述仓库配置.

更新

首先提交,然后从消费者仓库运行更新。 如果寄存器拥有其钩子,则明确保存:

bunx --bun @agentsfleet/orly update --no-hooks

预期:管理的文件被替换,更改显示在 git diff。带有未承诺更改的管理文件会停止更新并命名路径. 使用已安装的候选执行文件进行未公布的发布试验;上面的命令获取已公布的版本.

在不选择更新之前先审查已有的钩子 --no-hooks。 。 。 .

bunx --bun @agentsfleet/orly doctor

预期: 已安装规则匹配 .orly/orly.json 并宣布工作与核查命令. 然后运行存储器的申报检查; doctor 单靠自己不能管理他们.

仓库里有什么

your-repo/
│
├── AGENTS.md ─────────────── yours. untouched, except one delimited pointer block
├── .orly/AGENTS.md ────────── the always-on rules and the standards index
│
├── CLAUDE.md ─────────────── one import line; the only file Claude Code loads itself
├── opencode.json ─────────── names both rule files; opencode loads nothing by default
│
├── .orly/standards/ ──────── the rules, one page per language or domain
├── .orly/skills/ ─────────── full skill instructions
├── .claude/agents/ ───────── the standards reviewer
│
├── .claude/skills/ ───────── thin discovery entries per agent host
├── .agents/skills/
├── .opencode/skills/
│
├── .orly/hooks/ ──────────── pinned bunx pre-commit and pre-push calls
└── .orly/orly.json ─────── which packs, which commands, what orly installed

orly init 也包括种子 .orly/orly.json 在您身上找到任何门的命令 Makefile 或者说 package.json填满其余的, 承诺, 和每个克隆门都一样.

每次行动都会发生什么

flowchart TD
    edit["agent edits a file"] --> rule["the rule page for that file kind fires"]
    rule --> commit["git commit"]
    commit --> pre["pre-commit hook runs orly gate"]
    pre -->|red| back["blocked: back to EXECUTE"]
    back --> edit
    pre -->|green| push["git push runs pre-push hook"]
    push --> prgate["orly gate pr"]
    prgate -->|red| back
    prgate -->|green| open["Pull Request opens"]

三个检查站,所有运行你自己宣布的命令:

你生活的循环

orly init 是设置。 这是一项任务,从迅速到拉请求.

光谱是磁盘上的文件,而且 它的目录是状态。只有规则中命名的阶段才能移动它.

flowchart TB
    you["🤠 you<br/>add webhook retries"]
    agent["🦉 agent<br/>writes the spec"]
    pending["📄 docs/v1/pending/<br/><small>spec committed on default branch</small>"]

    you --> agent
    agent --> pending
    pending -->|"CHORE(open)"| plan

    subgraph active["⚙️ docs/v1/active/"]
        direction TB

        plan["PLAN<br/><small>understand spec · resolve decisions</small>"]
        execute["EXECUTE<br/><small>make the change</small>"]
        conform["CONFORM<br/><small>apply matching rule pages</small>"]
        verify["VERIFY<br/><small>run deterministic gates</small>"]
        review["REVIEW<br/><small>review the resulting diff</small>"]
        document["DOCUMENT<br/><small>update docs / evidence</small>"]
        commit["COMMIT<br/><small>record the completed unit</small>"]

        plan --> execute
        execute --> conform
        conform --> verify
        verify --> review
        review --> document
        document --> commit

        conform -. "gate fails" .-> execute
        verify -. "gate fails" .-> execute
        review -. "changes required" .-> execute
    end

    commit -->|"CHORE(close)"| done["✅ docs/v1/done/<br/><small>all gates green</small>"]
    done --> pr["Pull Request"]

内部 active/,工作贯穿各个阶段: 计划/执行/协调/核查/审查/文件/承诺。 。 。 .

阶段不是状态. active/ 是状态。 阶段是坐在那里的光谱上的循环.

三件事做三个不同的工作, 把它们分开是使生命周期机械化的原因:

每次编辑都会激活该文件类型的规则页。 一个闸门可以证明工程能否推进,任何红色都会将代理返回EXECUTE. 任何舞台都不能悄悄跳过.

你的档案还是你的

AGENTS.md 留在你身边。 或写它旁边的规则 从一个被划定的区块对着它们.

最后两个文件通过每次运行的加载器传递规则. 代码和 AMP 自动装入 AGENTS.md,它带有指针块继续前进.

Claude 代码装入 CLAUDE.md 没有别的了。 打开码只装入其内容 instructions 名称.

或者在装入器缺失时写入所需的导入,并刷新它自己划定的块或识别的生成的装入器. 无关所有者内容保持不变. 保存了寄存器内已解析的链接;未解析或出逃的链接拒绝更新.

[尖叫声] 或者拒绝无自有冲突的内容和可执行的所有人钩. 明确审查 --force 或者说 --no-hooks 选择之前进行. 飞行前冲突保留所有者字节 。 写作过程中的中断可能会留下已完成的步骤和日记;在解决冲突后重新运行以恢复.

图标

哪个包你得到

由您的消息来源选择

或扫描四个目录深处。 它跳过 node_modules, (中文(简体) ), target, (中文(简体) ), .venv,而其他依赖树,因此一个偏差文件无法选择您不写的语言.

包装	当您的源已选中
language.typescript	.ts, (中文(简体) ), .tsx
language.javascript	.js, (中文(简体) ), .jsx
language.rust	.rs
language.go	.go
language.python	.py
language.shell	.sh
language.mdx	.mdx
domain.sql	.sql

到处安装

选入,只有在 .orly/orly.json 给他们起名

需要格斯塔克和EGM

orly的技巧召唤 点心 代码审查和 大象-金鱼模型 (EGM) 用于光谱审查. 任何版本都可行,因为两者都自我升级.

orly doctor 检查每个代理运行时间 机器有两种. 一个缺失的将它变为红色并打印安装命令;技能停止到绿色. 没有代理运行时间的机器,例如CI跑车,跳过检查.

[注] 三种技能(orly-spec, (中文(简体) ), orly-build, (中文(简体) ), orly-ship)和审查员来自orly's workflow.skills 包,每个仓库。 每个代理主机安装gstack和EGM.

地方发展

因为工作本身。 欢迎拉动请求.

先决条件

设置

git clone [email protected]:agentsfleet/orly.git && cd orly
git config core.hooksPath .githooks
bun install --frozen-lockfile
make audit

那个酒吧

make audit 这是酒吧。 如果通过,变化是可以审查的。 它的步道平行运行,大约为半分钟:

• orly verify数字 : 标准目录、根渲染和每包复制件
• 类型检查和单位测试,包括确定性
• 大门固定装置: 每道门都证明有一条路过和一条故障

这里的每一个承诺都运行 bin/orly gate work,运行中 orly verify。 。 。 . 推车只跑出一圈 CI跑 make audit 每一个拉请求.

覆盖率为90%。 下方的工作流程失败 .

安装 evals

真正的安装到丢弃的仓库中。 价格是当地连锁店的两倍 所以他们按要求运行:

make install-evals

线人按每一次拉取请求进行操作并释放.

制定或修改自己的规则

或者用其他人使用的同一种动词来管理自己:

bin/orly update --no-hooks

--no-hooks 因为这个支票手写它 .githooks/,或拒绝替换它没有写的钩子.

释放

合并到 main 带有新的 package.json 版本。 出版 标记 剪掉GitHub版 没有第二个命令可以记住.

试试看

在您拥有的仓库中运行 。 在你降下国旗之前,它什么都不写.

bunx @agentsfleet/orly init --dry-run

它印出它将要安装的规则, 已经为您源代码中找到的语言 提供了规则 。 读取. 如果你不同意,这就是重点:你自己 AGENTS.md 超过它.

然后把你的经纪人交出来 即时或快速地为:

Read .orly/AGENTS.md. Tell me which of my last ten commits would have tripped a
gate, and name the rule that caught each one.

许可证

麻省理工学院