# @andresmassello/uscha 中文文档 规范地址：https://npmcn.com/package/%40andresmassello/uscha/ 版本：2\.14\.1 npm 元数据更新时间：2026-11-04T19:36:58.665Z 中文译文更新时间：2026-11-07T06:42:52.786Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40andresmassello/uscha 原文对照：https://npmcn.com/package/%40andresmassello/uscha/?lang=original 项目主页：https://uscha.dev/ 源码仓库：https://github.com/andresmassello/uscha ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.7 MB，64 个文件 - TypeScript 类型：未声明 - Node.js 要求：\>=18 - 运行依赖：0 个 - 首次发布：2026-07-09T23:11:37.066Z - 最新版本发布：2026-11-04T19:36:58.323Z - 近 30 天下载量：2027（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：76（近 12 个月 76 个） ## 中文简介 LLM编码代理的Spec驱动开发:9技能+一个stdlib证据引擎. 事实阻断,猜测建议;人类认可. ## 安装 ```sh npm install @andresmassello/uscha ``` 也可以使用：`pnpm add @andresmassello/uscha`、`yarn add @andresmassello/uscha`、`bun add @andresmassello/uscha` ## README # 乌沙 **Spec驱动的LLM编码代理开发.** _你带来这个想法,方法建立 其余部分._ Uscha 给一个编码代理来构建一个比对的 spec , 一个 QA 循环 , 汇聚 而不是永远循环, 和决定性的分类账 记录什么是 **测量** —— 说 从来没有声称什么. > 代理人执行方法 证据决定 人批准. **[维基百科中的相关条目: 维基语录链接:名人名言](https://uscha.dev/)** ——"方法","五通"规则,"技能","图书馆" (钻石论文、如何工作图、散文、两天课程、参考资料、纸张). **新来的? 开始 [首先使用:从安装到一个测量结果](https://npmcn.com/package/%40andresmassello/uscha/docs/FIRST-USE-EN.md)** - 一台机器,一台小回放, 一个标准关闭 一个真正的测试, 和合并留给你 (单位:千美元)[西班牙语](https://npmcn.com/package/%40andresmassello/uscha/docs/FIRST-USE.md)) (中文(简体) ). ```bash npx --yes @andresmassello/uscha@latest install --target claude # Claude Code npx --yes @andresmassello/uscha@latest install --target codex # Codex npx --yes @andresmassello/uscha@latest install --target cursor # Cursor npx --yes @andresmassello/uscha@latest install --target copilot # VS Code / GitHub Copilot npx --yes @andresmassello/uscha@latest install --target gemini # Gemini CLI npx --yes @andresmassello/uscha@latest install --target cline # Cline npx --yes @andresmassello/uscha@latest install --target pi # pi (Earendil) npx --yes @andresmassello/uscha@latest install --target all # every target at once npx --yes @andresmassello/uscha@latest doctor --target all ``` 这9个技能是: **代理技能** 标准,所以最后五个目标是相同的 将技能放在每个代理商自己的文件根下。 诚实的范围:只有克洛德代码和代码 已经对一个真正的代理人行使了权力,而对于其他代理人来说,他们负载是一个 _文档 期望,而不是衡量_。所测量的是,文档是每个代理的所在 文档读取它们和 `doctor` 读回来 INV-GOLDEN-01是机械 仅用 Claude 代码执行( 屏蔽 PreTools Use switch); 其他任何地方 `doctor` 报告 作为 `advisory` 而不是暗示它看不见的警卫. (单位:千美元)`both` 保留给 codex+Claude 的外名。 ) 然后,在你的项目中: ```bash npx --yes @andresmassello/uscha@latest init ``` 要求数 **Py 3.8+** 在机器上(引擎是 Python stdlib —— 没有 pip 安装, 没有 运行时间依赖关系)。 npm 包是一个很薄的路由器; Canonic 安装器是 `uscha-kit/install-uscha.py`。 。 。 . `init` 也写一个最小的, 每类的 `.gitignore` 当 项目没有( kit 2. 4. 0) —— 它从未列出 `reports/`,分类账本身的证据. 工具箱宣布不依赖, 并安装任何依赖 。 自装备2.7.0起(ADR-052) `install` 结束 带有 **额外报告** 安装器 `doctor` 作为咨询部分重复:如何 dev 环路的QA工具(`code-review`, (中文(简体) ), `judgment-day`, (中文(简体) ), `improve`,工具包默认顺序) 在目标机器上——通过发动机自己的解析器,所以 `code-review` "假设, ——以及可选的语法(uscha不需要) 存在,并附有添加的命令。 目前表示可从 Claude 使用: 内插件 安装和启用,或命名为 MCP 的服务器 `engram` claude 配置; 空 pATH上的二进制读取了"二进制找到,没有被接入克洛德". MCP检查只读克洛德 配置,用于 `--target codex` 我也一样。 它只报告:它不安装任何东西,不要求任何东西 运行它打印的任何命令,它永远不会修改退出代码. **Kit v 2.14.1 (英语)** • 妇女 [维基百科中的相关条目: 维基语录链接:名人名言](https://uscha.dev/) • 妇女 [更改日志](https://github.com/andresmassello/uscha/blob/main/uscha-kit/CHANGELOG.md) (每发换行日志活于回波,不是npm柏油球) * * * ## 问题解决 经纪人会告诉你考试合格 它会告诉你这个功能完成了。 经常是这样 是的,当它是错误的, 你发现生产. 乌斯察拒绝接受代理人的言语. 每一个权利要求都必须是: 代理商没有写报告: JUnit文件、覆盖报告、linter文件 输出。 对于执行的测试,没有希望(2.10.0):引擎运行测试命令 你的项目宣布`test-run`),记录运行情况,其大门只尊重JUF和 运行的覆盖文件——其他人撰写、复制或编辑的报告不是 证据。 仍然信任的是宣布的命令本身:评论员读取的配置行. **事实障碍;猜想建议.** 手取的复选框记录为 `narrated` 并且不关闭一个标准。 以该标准命名的测试,绿色,在 报告记录 `test-run` 写着——结束了. 结果是您可以信任的准备得分, 因为您可以点击任意数字 看哪个文件,哪个测试,什么时候. ## 你得到的东西 **9个技能** 驱动方法结束: | 技能 | 它会做什么 | | --- | --- | | `/uscha-discovery` | 想法-光谱包(CONTEXT、SPEC、发展成果评估、宪法、接受) | | `/uscha-adr-refine` | 已知特征 + ADR + Acceptance,通过先询问您 | | `/uscha-reverse-discovery` | 现行制度-事实+在隔离中打字的候选人;未经人类判决,从未晋升(布朗菲尔德) | | `/uscha-characterize` | 在触摸它之前,先抓取一套金色的当前行为 | | `/uscha-devloop` | 计划 • 建立 • 重度的QA环 → PR(停止合并) | | `/uscha-rubric` | 对照一个版本标题对不可测试的(公约、人类学)进行分级 | | `/uscha-sysdoc` | 从分类账中生成一个系统甲板 | | `/uscha-mirador` | 鸟眼 HTML 仪表板:准备、跟踪、接受、环 | | `/uscha-status` | 聊天中单行进度读取 | **一个测量引擎** (单位:千美元)`qa_ledger.py`, 62 个子命令, Python stdlib) ,用于摄取 证据来源 **11个语言堆栈** - 玛文克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特克特, cpp,快活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活. ## 兼容性矩阵 目标和安装路径列镜像 `TARGETS`编号 :`SKILL_ROOTS` 在安装器中。 这个 _已执行_ 列为编辑性,未生成:上次更新为2026-09-20(ADR-049). | 目标 | 代理人 | 安装到 | INV-GOLDEN-01 (英语) | 对真实代理人行使 | | --- | --- | --- | --- | --- | | `codex` | 代码 | `~/plugins/uscha` | 咨询 | **对** | | `claude` | 克劳德代码 | `~/.claude/skills` | **已执行** (PreTools使用钩子,最优等) | **对** | | `pi` | pi (耳蜗) | `~/.agents/skills` | 咨询 | 无——只放入+回放 | | `cursor` | 光标 | `~/.cursor/skills` | 咨询 | 无——只放入+回放 | | `copilot` | VS 代码/ 副驾驶 | `~/.copilot/skills` | 咨询 | 无——只放入+回放 | | `gemini` | 双子座CLI | `~/.gemini/skills` | 咨询 | 无——只放入+回放 | | `cline` | 线 | `~/.cline/skills` | 咨询 | 无——只放入+回放 | **"实践"是一栏重要的.** 除了克洛德 代码和代码 每一个目标 被测量的是,这九个技能的地 在那里,代理记录读取它们 `doctor` 读回来.. _他们的负载是记录的预期,而不是衡量._ INV-GOLDEN-01 只有在有屏蔽前工具钩的情况下才进行机械试验 其他情况 `doctor` 报告 `advisory` 而不是暗示它看不见的警卫. | 监督办 | 如何核实 | 状态 | | --- | --- | --- | | 链接 | CI 矩阵 (py3.8 + py3.13) + 本地 WSL | **测量** | | 窗口 | CI 矩阵(py3.8 + py3.13) + 本地 | **测量** | | 马科斯 | CI 矩阵(py3.8 + py3.13),真跑者 | **测量** | ## 循环,简而言之 1. **模特儿先来.** `/uscha-discovery` (新)或 `/uscha-adr-refine` (已知特征)写作 光谱包。 在软件包存在之前没有代码 . 2. **盖起.** `/uscha-devloop` 与SPEC对抗的装置,以测试为护栏. 3. **QA环.** 独立审查通行证(maker QQ检查)运行到更改 **趋同** - 严重性或严重性以上的发现被固定,其余的去 `ISSUES-DEFERRED.md` 他们的证据。 自2.11.0起,引擎见证每次审查 (单位:千美元)`review-start` 标记它开始的树 : 门形的发现只关闭在后期的清洁上 对不同来源的审查,或自2.14.0起,通过推迟其自己的身份证明,并经a 人类(ADR-060);对每个工具的最后一次审查,肯定看到磁盘上的代码了 (ADR-056) (英语). 康维尔,不要追零. 4. **准备.** 一个分数,一个屏幕:接受(测量)30分 静态门20分 ADR 15 覆盖 15 趋同 10 集成 10 有硬盖表示 _为什么_ 以及阈值是否是你的要求 还是包的默认值. 5. **你决定.** 代理人在公关提出,采取措施并停留. 合并是一种人类行为, 解除升级也是如此:由于这些命令需要2.12.0 `--human`编号 :`--note` 财务报告和审定财务报表 claude Code的外壳里拒绝 钩子在门是红色时会保留公关草稿 (ADR-058) (英语). ## 是什么让它不同 - **测量的节拍叙述.** 接受标准结束于绿色测试 其名称 — 绝不在复选框中。 收集证据(一份其运行测量结果不同的报告) 和未见证据(未记录的报告) `test-run` 写)是 被丢弃,没有荣耀——每一次门读出它们,就重新产生. - **缺席不是成功.** 从来没有过分的门 `UNMEASURED`,这是 蓄意 _没有_ 与衡量的零一样——它也没有默默地被原谅. - **收据.** 仪表板上的每一个数字都追踪到它的证据:哪个测试箱,哪个 报告,时间戳. - **反正礼.** 盖茨默认保持安静,倒塌成一条判决线. 这个 方法由引擎执行,而不是要求代理人遵守纪律. - **模型不可知论.** 引擎从不读取代号,型号名称或销售商遥测. 任意 模型上报的数字通过适配器输入,从不输入引擎. - **野外真相换绿地.** 在新系统中,每个试验有效载荷都是由 密码的代理商,所以 `corpus-run` 对一组真实输入进行评分 实际指挥和坚持百分比为事实——咨询直至项目 宣布预算,一旦完成就宣布封锁门(ADR-046). - **证据被执行,没有叙述.** 烟雾是项目的工具 写入,而不是段落为代理类型(不同于测试报告,烟雾报告仍然读取) - 尚未通过记录的跑道(ADR-055): `smoke-ingest` 读取 `{"checks": [{"name", "ok", ...}]}`,一个失败的检查块,比如任何事实门,和一个空的或畸形的 报告被拒绝,而不是得分(ADR-047). ## 钻石—— specs 是源代码,结束到结束 Uscha关闭了一个循环 大部分的光谱驱动工具只行走一半。 这个 **光谱包加它 行为分类账** 是一个系统的犬科资产; 代码是可再生的建筑文物. LLM 根据有效的合同将包编译为代码; 反向发现分解 已存在的代码返回到 _管理_ - 绝对通过不 自动工具可以执行:人类判断. ``` THE ASSET (solid) ── it appreciates with every model generation ┌───────────────────────────────────────────────────────────────┐ │ SPEC PACKAGE + BEHAVIOR LEDGER + IR │ │ SPEC · ADRs · ACCEPTANCE · CONSTITUTION │ │ verdicts: preserve · fix · undefined │ └──────────────┬─────────────────────────────▲──────────────────┘ │ │ FORWARD │ │ REVERSE the LLM compiles │ │ reverse discovery ▼ │ ┌─────────────────────────────────────┐ ┌─────────┴─────────────────────┐ │ compile-validate — output contract, │ │ CURATION · the human gate │ │ mechanical only, model-blind │ │ candidate ─▶ verdict ─▶ ledger │ │ withheld ORACLE — authored BEFORE │ │ no verdict → PR blocked, │ │ compiling, never in the prompt │ │ the candidate is NAMED │ └─────────────────┬───────────────────┘ └─────────▲─────────────────────┘ │ │ ▼ │ ┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐ ┌─────────────┴─────────────────────┐ CODE (dashed) — build artifact, │ discover · golden capture │ regenerable, disposable ───▶│ candidates: typed evidence │ └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘ │ + confidence │ └───────────────────────────────────┘ ▲ also enters here: any LEGACY system (= 100% drift) round trip · bench-roundtrip — how much of the asset the reverse organs re-anchor from the compiled code: 0.815 measured (12 archetypes) — names AND behaviour ``` **每个箭头在引擎中是什么(62个子命令,全部测量) :** | 脚 | 子命令 | 它的建立 | | --- | --- | --- | | 资产-类型图 | `ir-extract`, (中文(简体) ), `ir-render` | 整个包成了一个可控的IR(M2,ADR-015)——决定论, `UNTYPED` 是测量而不是错误 | | 前进, 编译器 | `compile-validate`, (中文(简体) ), `compile-ingest` | 任意模式生成代码; 引擎验证输出合同, 并且从未编译( M3, ADR-016) | | 前进,是 _不变_ 系统? | `bootstrap-oracle`, (中文(简体) ), `bootstrap-variance`, (中文(简体) ), `bench` | 被扣的神谕法官盲目汇编—— **12个型号,8个PASS 4个部分(2026年9月计量)**,横跨两个销售商的4个盲编译器(Haiku ^ Sonnet → Opus → OpenAI Codex) `gpt-5.5`联合来文包括(M4/M5、ADR-017/018/028/029/042) | | 倒置,事实 | `discover`, (中文(简体) ), `golden-diff` (+ 数字 `/uscha-characterize` 技术) | 系统映射 + 机械捕获的金; 输入有证据类的候选观测数据( M1, ADR-013) | | 倒车 人行道 | `curate`, (中文(简体) ), `promote`, (中文(简体) ), `curation-check`, (中文(简体) ), `bench-curate` | 每名候选人一个判决,仅一个附件分类账,对照基特核实;未判决 = `pr-ready` 被屏蔽的命名( ADR- 009/ 010, INV- Culation-01) | | 忠诚,诚实的 | `fidelity`, (中文(简体) ), `roundtrip`, (中文(简体) ), `bench-roundtrip`, (中文(简体) ), `bench-r2` | 每编译者忠贞矢量,id-level回程,可回收性 **0.815 (中文(简体) )**,则 **噪音地板** (ADR-014/022/027/030) | **念出如来回所行等数.** 12个型号中的8个型号(被测量为2026年9月;有4个盲编译器——Haiku, Sonnet, Opus和OpenAI Codex gpt-5.5)重生为同一种系统 在编译者从未见过的甲骨文下——即闭合回路工作. 12个中只有9个 1.99.0, 当第二个供应商的第四个编译器读作一个真正模糊的句子时 `transformer` 克洛德家族的三种模式都同意 (ADR-042) (英语). 号码倒了 因为凳子变硬了 整个手臂的点是 让它。 由于2.2.0 该标题是一个 **衍生事实**数字 : `qa_ledger.py facts` 计算判决数 行数 `DIAMOND-BENCH.md` ——报告 `bench` 产生在承诺的固定点上 `SYSTEM-FACTS.json`,以及 `facts --check` 把每份公布的拷贝 都比起来. 是因为项目主页上写着9/12 之后的9版 移动,这些版本中每一个都是绿色的: 主张包含一个 HTML 元素及其名词 在下一个, 其中大门看不到它。 0.815是恶性 _可回收性_ 只计算已编入代码的资产 静态和行为 它读 **0.062号** 1.9.0之前,包括行为层面 `UNMEASURED`,因为没有甲骨文案件带有AC标记——一个被命名的缺席,而不是一个零. 12个 现在每个案件都由法官审理(`ORACLE-TAGS-CURATED.json`有效载荷和 数字表示反向器官 锁定 **姓名和行为**读作:3个编译器0.828个,4个,因为 条目的可回收性是其汇编的平均值。 每个数字都公布 他们之间移动的是标记和手臂,而不是正在测试的密码. 还有 `bench-r2` 测量 同型号的重跑在结构上和不同型号一样不同(汇总) `NOISY`因此,早先的一个差异说明是: **已撤回**。上面的每一项索赔都是一个子命令 您可以运行;每个未测量的部分都有标签。 这种诚实是适用于自己的方法. 上面的每个判决都与一个命名的标准挂钩, 每一个被判定的人都与 签名的人——分类账本身, `bench-curate --human` 用于编译的文物,以及 页:1 `origin: agent` 记录代理商提议的规格项目与 人类决定. \- 论文全文,附有图前/图后,以及REAL vs VISION vs REJEDED表: **[钻石公司](https://uscha.dev/diamond)** 机制,分三个图: **[(原始内容存档于2013-10-12). uscha.dev/how](https://uscha.dev/how)** * * * ## 文档 - **[`uscha-kit/INSTALL.md`](https://npmcn.com/package/%40andresmassello/uscha/uscha-kit/INSTALL.md)** ——全安装向导(npm, git, 插件) - **[`uscha-kit/README.md`](https://npmcn.com/package/%40andresmassello/uscha/uscha-kit/README.md)** - 工具包参考:配置,每 子命令、 准备状态 KPI、 简单并重建闸门 - **[`docs/`](https://npmcn.com/package/%40andresmassello/uscha/docs/)** ——长甲板,接线员游戏本,技能参考和 一页(ES + EN) - **[`docs/adr/INDEX.md`](https://npmcn.com/package/%40andresmassello/uscha/docs/adr/INDEX.md)** ——每个架构决定,按谁归类 需要它,有五ADR读取顺序 新来者 - **[`docs/paper/`](https://npmcn.com/package/%40andresmassello/uscha/docs/paper/)** - 写成纸的方法 每艘释放舰a `uscha-kit/CHANGELOG-X.Y.Z.md` 解释什么是改变和为什么. ## 发展乌沙本身 这个寄存器是工具箱的来源,该方法被应用在自己身上: 其本身 `uscha.config.json`, (中文(简体) ), `ACCEPTANCE.md` 财务报告和审定财务报表 `CONSTITUTION.md`它的准备 以它所运载的同一种发动机测量. ``` uscha-kit/ # canonical source of the kit .claude/skills/ # the 9 skills + qa_ledger.py (the engine) templates/ # CLAUDE.md · CONSTITUTION.md · scripts · docs/adr tests/smoke-engine.sh # the suite every engine change must pass docs/ # published artifacts (ES/EN twins) + the paper audits/ # adversarial audit outputs ``` 规则在 [`CLAUDE.md`](https://npmcn.com/package/%40andresmassello/uscha/CLAUDE.md)。简短的版本:任何医生都不得声称 引擎不这样做; ES 和 EN 双胞胎一起旅行; 每一次引擎变化都带有 烟雾测试;和 PreTools Use 钩使代理机无法写入 `.approved` 黄金. **老实说**: 那个钩子是 _最佳成绩_ 守卫,它注册在克洛德号上 只有目标——它检查一个工具调用为 TEXT,所以间接写入(一个集合的脚本) 文件名、 符号链接) 和所有其他目标报告 `golden_guard: advisory`MEASURED控制为 `golden-diff`,比较字节。 第二钩子, `guard-pr-gate.py` (2.12.0) 保留抽拉请求,同时 `pr-gate` 读取红色 -- -- 相同 范围,同样的诚实: Claude只使用文字,以及 `doctor` 报告 `pr_guard`。 。 。 . ## 历史 作为与克洛德法典合作的一种方法诞生,与Böckeller原则相提并论 进行两次对抗性审计(231次) 找到核心原则的代理人 **代码倒转** -1.3.0转右了. 详情见 `audits/` 和在变更日志. ## 许可证 麻省理工学院——见 [`LICENSE`](https://npmcn.com/package/%40andresmassello/uscha/LICENSE)。 。 。 . ## 常见问题 ### @andresmassello/uscha 是什么？ LLM编码代理的Spec驱动开发:9技能\+一个stdlib证据引擎\. 事实阻断,猜测建议;人类认可\. ### 如何安装 @andresmassello/uscha？ 在项目目录运行 npm install @andresmassello/uscha，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 uscha、uscha-kit，可以用 npx uscha 直接运行。 ### @andresmassello/uscha 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/andresmassello\_\_uscha 是否存在。 ### @andresmassello/uscha 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @andresmassello/uscha 可以商用吗？ @andresmassello/uscha 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @andresmassello/uscha 的下载量有多少？ 根据 npm 官方下载统计，@andresmassello/uscha 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,027 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @andresmassello/uscha 还在维护吗？ 最新版本 2\.14\.1 发布于 2026/11/05（3 天前）；至今共发布 76 个版本，其中过去 12 个月发布了 76 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。