SuperAPI AI 工具集

orca-ledger

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:通过 Orca 的 ledger CLI(orca ledger ...)把项目或团队的工程观察记录成持久、带类型的条目,适用于需要跨工作树保留的场景,例如提交 bug、延期项、测试缺口、提案或决策。账本存放在 Orca profile 中而非 git 检出目录,因此条目在工作树删除后仍存在,并对同一项目的兄弟工作树可见。

主要能力:提交、列出、显示与分诊已有记录;在乐观修订前置条件下编辑内容或变更生命周期状态;回滚到较早修订;导入遗留的 BUGS.md、DEFERRED.md、TEST_BACKLOG.md、proposals.md 和 docs/adr 文件。

使用方式:先确定本次会话要用的可执行文件并全程复用。若设置了环境变量 ORCA_CLI_COMMAND,使用其值;否则若开发检出暴露 ORCA_DEV_REPO_ROOT,使用 orca-dev;否则在非 Orca 管理的 Linux 终端上使用 orca-ide,不要裸跑 orca,因为在 Orca 终端之外它通常指向 GNOME Orca 屏幕阅读器(/usr/bin/orca)并会启动语音;其余情况使用 orca。下文 ORCA 是占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA。运行前先用 ORCA skills get orca-ledger 加载与版本匹配的指南。优先使用 --json;指南未覆盖的命令或标志可查看所选可执行文件的 --help。若命令提示 Orca 未运行,用 ORCA open --json 启动后重试。若报 runtime_access_denied,说明沙箱阻止了连接,应以提升权限重跑,不要运行 ORCA open 或重启 Orca。若 skills get 未知,说明更新 Orca 可恢复指南;此时可用 --help 做只读探索,不要猜测不支持的命令。若所选可执行文件无法运行,报告其确切错误并停止,不要改用其他可执行文件,以免静默指向不同的 Orca 构建。

限制:账本存储在 Orca profile 而非版本库;命令覆盖范围以版本匹配指南和 --help 为准;需注意沙箱权限与终端环境差异。其他细节暂未提供。