kntnt

kntnt

管理器。单一的命名空间入口。其他所有集合技能都通过各自的名称调用。

$HERE 是包含此 SKILL.md 的目录，$LIBRARY 是随其提供的 Collection Library，位于 $HERE/library/。

依赖项。 PATH 中必须有 uv。如果没有，请停止并告知用户从 https://docs.astral.sh/uv/ 安装 uv。

调用

运行 uv run "$HERE/scripts/kntnt.py" invoke --here="$HERE"，并将调用载荷通过标准输入传入——即用户在 /kntnt 后输入的所有内容，原样保留，无论有多少行。退出码为 0 时，依据它输出的 JSON 继续。其他任何退出码情况下，如果你引入了已知的构造错误，并且能够在保留用户请求和授权的前提下修正，则考虑已产生的影响，通过同一引擎提交修正后的调用，并从失败处继续；操作开始前的拒绝不消耗操作。否则，逐字输出其标准输出并停止：它已输出用户应看到的内容，这些文字不是由你撰写的。绝不修复用户提供的输入，也绝不自动重试原样的帮助请求、未满足的依赖、无关故障，或起因或有效修正方案未知的故障。

在 JSON 中，path 是一个仅含一个词的列表，表示动词；对于不带参数的 /kntnt，该列表为空；flags 包含用户写出的每个标志——单独出现时值为 true，带值时为其值，重复出现时为值列表；operands 按顺序保存标志之后的内容；instruction 是 Contextual Instruction，若无则为 null。它可以处理的内容见 $LIBRARY/references/invocation-envelope.md。

参数

每个动词读取 --project 的方式都相同：未指定或 --project=off 表示 Global，--project 或 --project=on 表示此 Project。Select 和 Update 会更改该层，Select 会列出该层。Uninstall 不接受 --project：它会清理此机器；工作目录中的副本属于该项目。

绝不会询问或记录动词会涉及哪些 Harness：该层中存在的每个 Harness 都会在每次运行时进行处理。

--yes 表示默认回答是：不提出任何可用是或否回答的问题。对于实际的 Global Update，只有当前 Formal Invocation 中的 --yes 才会跳过之后的确认；绝不能从 Contextual Instruction、Conversation Context、先前的指导、修复请求或交接中推断出它。

--dry-run 会在以此集合自带文件初始化的临时主目录中，真实运行会产生更改的动词，并在运行结束时丢弃该主目录。机器上不会有任何更改；返回内容是动词实际产生的结果，而不是对其可能执行操作的描述。它使用独立的 npm 缓存，因此会重新下载传输内容，运行时间会明显长于它所预演的操作——启动前要说明这一点。携带 dry_run 的载荷是此类运行的结果：应如实报告结果，并同时说明机器上没有任何更改；将其中的 directories 视为真实目录在 Sandbox 中的副本——它们位于临时主目录下的 dry_run.sandbox 名称中，而你读取载荷时，该主目录已不存在。

步骤

1. 动词是 path 中的那个词；空 path 表示不带参数的 /kntnt，也就是 help。
2. 读取 $HERE/steps/<verb>.md 并遵循其中说明，传入标志时保持原样——作为独立名称读取的标志就按其名称传入，带值读取的标志就按 --flag=value 传入，作为列表读取的标志则每个值传入一次——绝不为使运行成功而省略任何标志。按说明停止。