Arketum

Name: Arketum
Author: rlabs.cl

本地服务

@rlabs.cl开发工具

关于 Arketum

使用 Agent 构建软件的经过验证的生命周期：单元、人工把关点和需求

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cl-rlabs-arketum": {
      "command": "npx",
      "args": [
        "-y",
        "@rlabs-cl/arketum"
      ]
    }
  }
}

启动命令npx -y @rlabs-cl/arketum

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@rlabs-cl/arketum1.1.0stdio

工具

收录的工具列表 · 更新于 1 天前

参数	类型	必填	说明
due	string	否	`defer`：截止日期，采用 ISO 8601 日期格式。
ids	array	否	`requisito`：要查询的需求，格式为 `<artefacto>:<id>`；或不带类型的意图，格式为 `<artefacto>/<id>`。
cita	string	否	`decide`：对话中此人已决定此 gate 时所说的原话；通过聊天记录，不再询问。`telemetria`：此人接受或拒绝时所说的原话。仅限确实说过的内容，绝不能写你自己的话。
gana	string	否	`elegir`：语义冲突中此人选择其版本的工作单元（填写 `requisito` 和 `porque`，使用此人的原话）。绝不能写你自己的话。
lane	object	否	`open`：泳道名称；可选填写确切版本。
lane.name	string	是
lane.version	string	否
lote	integer	否	`auditoria`：请求或报告的批次编号。
modo	enum	否	`modo`：此人对此会话选择的模式：`paralelo`（实施期间继续收集信息）或 `secuencia`（先实施，再继续定义）。绝不能写你自己的选择。paralelo \| secuencia
note	string	否	`pause`：说明剩余事项及后续步骤。`desbloquear`：说明如何解决（可选）。`decide`：搭配 `ajustar` 时，说明要调整的内容（必填）；搭配 `no_entiendo` 时，说明此人的疑问（可选）。
pide	enum	否	`solicitar`：请求此人作出决定的事项（`sin_e2e`：说明某项功能无法进行自动端到端测试）。conformidad \| retiro \| defecto \| decision \| sin_e2e
root	string	是	项目根目录
slug	string	否	`open`：工作单元的短名称；其 ID 为 `<carril>-<slug>`。
step	string	否	`defer`：延期的步骤。`decide`：你提出的 gate（`carril` 或步骤 ID）。带 `evidence` 的 `submit`：如果多个步骤共用该要求，则填写步骤。
tema	any	否	`tema`：留下待讨论的主题（`titulo`；`de`：此人提出时填写“persona”，并附其原话；由你提出时填写“agente”；`contexto`、`preguntas` 和 `propuesta` 可选：负责处理该主题的工作单元，填写 `carril`、`objetivo`，并可按需填写 `clase`、`ids`、`toca` 和 `opciones`，即由此人选择的路径）；或关闭主题（`cierra`：主题 ID；`como`：“convertido”并填写已打开的`unidad`，或“descartado”并填写`motivo`和此人的原话）；或转达此人在聊天中的回复（`responde`：主题 ID，并附其原话；不关闭主题）；如果此人决定，也可一次性关闭整个组（`cierra_grupo`：组 ID 和其`huella`，即批次和带有 `grupo` 的`tema`所提供的内容；填写 `como` 及关闭单个主题时所需的相同信息）。不带 `tema` 时，按来源和意图分组列出未关闭的主题（每组列出前几项；使用 `grupo` 列出整个组）。`open`：未关闭主题的 ID（文本）；从其提案中采用调用中未提供的内容（泳道、目标、涉及项、分类；slug 即其 ID），打开后将主题关闭为已转换成工作单元。
tope	any	否	`delegar`：委派的上限，以其下已打开的工作单元数计（5、10 或 20；默认 10）；或 `sin_tope`：在此人撤销委派前持续有效，每 `resumenCada` 个工作单元在批次中提供一次摘要。
unit	string	否	工作单元 ID（`<carril>-<slug>`），适用于除 `open` 以外的所有操作（`requisito` 中可选）。
agent	string	否	你是谁（例如，`<cliente> / <modelo>`），标记为已声明。对于 `open`（或在此连接中该工作单元尚无 Agent 时的 `resume`），此身份将签署该工作单元后续的内容；对于其他任何记录内容的调用，只签署该次调用。子 Agent 必须在每次调用中传递此值：它与主 Agent 共享连接。
desde	string	否	`decide` 搭配 `rechazado` 和 `mantener`：如果原因提出质疑，则填写恢复工作的前置步骤。
grupo	string	否	`tema` 不带 `tema`：未关闭主题组的 ID（列表、批次和状态中会显示），用于列出整个组。
owner	string	否	`defer`：负责偿还该债务的人。
papel	string	否	`levantar`：提交该部分的调研角色（声明为 `analista` 或 `arquitecto`）。`status` 搭配 `unit`：当前阶段该角色的资料包；在系统步骤或证据步骤中，也可以是形式变体的实现角色（指南中列出了这些角色）。
parte	object	否	`levantar`：调研部分，包含其 `kind`（`situacion`、`conversacion`、`senales`、`propuesta`、`respuestas`、`consolidacion`、`fuera_de_alcance` 或 `reabrir`）及其字段。
paths	array	否	语料库路径。仅在存在不含 `proyecto.yaml`（且不是旧格式）的 `.arketum/` 时使用：从中获取旧版原型候选项及其问卷。没有 `.arketum/` 时会忽略这些路径：每次调用都会获得文件夹的启动状态（新建、有基础或已存在）。工具只提出建议，从不安装。
scope	enum	否	`decide` 搭配 `rechazado`：功能是保留还是移除；两种情况都需提供 `reason`。mantener \| quitar
texto	string	否	`decide` 搭配 `decidir`：已确定的文本，用于创建 `decision` 的新版本。
acepta	boolean	否	`telemetria`：此人是否同意（`true`）发送匿名使用摘要（`false` 表示不同意），并通过 `cita` 提供其原话。绝不能填写你自己的话。
action	enum	否	可选，仅适用于 .arketum/proyecto.yaml：对工作单元执行的操作。`status`（带 `unit` 时查询该单元；不带时查询项目、单元索引和需求索引）、`open`、`resume`、`submit`、`defer`、`pause`、`close`、`decide`、`rescope`、`renew`（建议刷新树的快照）、`politica`（当项目当前策略与单元中设定的策略不同时，建议设定项目当前策略：一个 gate）、`instructions`（根据策略生成的指令文件文本，其中声明了各目录）、`requisito`（查看 `ids` 中需求的详情）或 `solicitar`（请此人决定已触及需求中的一项：一个 gate）、`levantar`（第 1 阶段调研中的一个部分，包含其 `papel`）、`formas`（系统形式：其 `aplica`、设计和缺口；哪些形式适用于给定的 `senales`，以及其他形式不适用的原因；使用 `stacks: true` 时，也包含 stacks）、`deriva`（功能偏移：需要重新执行的内容；或使用 `informe` 查看发现）、`elegir`（传递此人在语义冲突中选择的版本）、`actualizar_almacen`（不带 `unit`：更新存储格式，将 `.arketum/` 中的决策从单一文件改为每个决策一个文件；`migrar` 是其旧名称，调用时会被拒绝，并引导至此操作或原型迁移；这不是将仓库迁移到其他原型）、`estado`（不带 `unit`：项目的简明计算状态，包括哪些事项在等待此人、哪些正在进行以及开始时间；使用 `status` 查看详情）或 `tanda`（不带 `unit`：记录此人在 `.arketum/decisiones-pendientes.md` 中标记的内容，并将文件重写为仍待处理的内容；使用 `esperar` 时，会先等待此人保存文件）、`identidad`（不带 `unit`：此机器上的决策者身份，使用 `nombre` 或 `correo`，按此人所述填写）`abandonar`（让某个单元暂时搁置但不关闭，可选提供 `reason`）`tema`（不带 `unit`：要讨论的主题；带 `tema` 时，可搁置、关闭或回复一个主题）、`mapa`（不带 `unit`：根据 boundaries 计算的项目集成图；带 `artifact` 时，查看某个工件的集成图）、`auditoria`（不带 `unit`：根据索引进行审计，按相似内容分批，从新到旧，并跳过未变更的内容；使用 `completa: true` 时审计全部内容；使用 `informe` 和 `lote` 时，提供发现及按意图合并的结果，并将其作为主题；每批还会询问不安全之处；如果此人提及了安全策略，则会依据 `politica` 进行检查）、`prd`（不带 `unit`：计算生成的实时 PRD；按工件列出按措辞相似度分组的当前需求（即审计批次；不代表意图判断），并包含需求状态、版本、创建该需求的单元以及 PRD 之间的修订；带 `artifact` 时查看某个工件的 PRD；按页查看时使用 `pagina`）`panel`（不带 `unit`，在开始工作时使用：在机器面板中登记项目，生成启动脚本，并提供项目地址或启动命令）、`modo`（不带 `unit`：按此人的选择指定本次会话的工作方式：`paralelo` 表示在实施已就绪内容的同时继续收集信息；`secuencia` 表示先实施，再继续定义；使用 `subagentes` 指定客户端是否可以委派给子代理；不带 `modo` 时查询当前模式）、`bloquear`（将正在实施的单元标记为阻塞，并提供 `reason`：说明哪些问题无法在没有此人协助时解决；不会中断信息收集）、`desbloquear`（表示阻塞原因已解决，可选提供 `note`）或 `telemetria`（不带 `unit`：Arketum 请你询问此人是否同意发送匿名使用摘要时，此人给出的答复，包含 `acepta` 和 `cita`；这是安装级设置，而非项目设置）。不带 `action` 时，入口会在单元之外按工件提供内容。status \| open \| resume \| submit \| defer \| pause \| close \| decide \| rescope \| renew \| politica \| instructions \| requisito \| solicitar \| levantar \| formas \| deriva \| delegar \| elegir \| migrar \| actualizar_almacen \| estado \| tanda \| identidad \| abandonar \| panel \| tema \| mapa \| auditoria \| prd \| modo \| bloquear \| desbloquear \| telemetria
correo	string	否	`identidad`：此人用于表明身份的邮箱。
hereda	boolean	否	单元系统步骤中的 `submit`：`inventory.items` 仅包含新增和已更改的内容；其余内容继承自基线（最近一个将其派生出来的已关闭单元中该工件的同一级别），Arketum 会合成完整级别。不适用于有输入的 L0。
huecos	boolean	否	`auditoria`：Arketum 计算出的缺口和偏移（手动更改的形式信号、未配备 stack 固定项的形式输出、作者审核通过后架构新增的内容、没有对应项或未声明的 boundaries、重复需求：仅重复标题的描述，或标题或描述相同的功能需求与技术需求）；每项均作为一个主题并附带建议。
nombre	string	否	`identidad`：此人用于表明身份的姓名（不使用登录名）。绝不能填写你推断出的姓名。
opcion	integer	否	`open` 搭配 `tema`：此人选择的建议路径（从 1 开始）。
pagina	integer	否	`prd`：所请求的实时 PRD 页码（从 1 开始）。
porque	string	否	需求 gate 中的 `decide`：原因（与 `retirar`、`decidir` 和 `sin_e2e` 搭配时必填）。
quitar	array	否	与 `hereda` 搭配：从该级别移除的基线 ID。
reason	string	否	`defer` 和 `rescope`：原因。`decide` 搭配 `rechazado`：拒绝原因；搭配 `quitar` 时也必填。`bloquear`：无法在没有此人协助时解决的问题（除与 `enmienda` 搭配外均为必填）。
stacks	boolean	否	`formas`：设为 `true` 时，也会列出 stacks（及其示例树）和单层原型，供架构选择。
urgent	boolean	否	`open`：是否紧急；只有紧急单元会推迟步骤。
catalog	string	否	在批准含有候选原型的步骤时使用 `decide`：此人选择将其发布到的目录（摘要中会列出）。
esperar	number	否	`tanda`：调用等待此人保存 `.arketum/decisiones-pendientes.md` 的分钟数（最多 30 分钟）；如果客户端提前中断调用，请再次调用或让此人通知你。
informe	object	否	`auditoria`：`lote` 的报告（`revisor`、`revisados`、`hallazgos` 和 `consolidaciones`：追求相同目标的内容，提议合并为一个 PRD），与追溯验证相同。`deriva`：你编写的功能偏差报告：`reejecuciones`（每项需求执行一次，并附准确命令及其 `codigo`；或标记为 `no_ejecutable` 并说明原因）和 `sin_requisito`（已完成但不属于任何需求的内容）。没有该报告时，`deriva` 会说明要重新执行什么。不会更改任何状态。
resumen	enum	否	`delegar`：针对当前委派摘要，人员通过聊天作出的回复：“继续”或“撤销”（如有评论，则放在 `note` 中）。与批次和面板中记录的事实相同。不要自行决定。sigue \| revocar
revocar	boolean	否	`delegar`：撤销当前有效的委派；Arketum 将再次针对每个 gate 询问人员。与批次摘要中“撤销”记录的事实相同。
senales	object	否	`formas`：系统信号（由表单声明，并带有类型），用于确定适用哪些表单。
touches	array	否	`open` 和 `rescope`：该单元会触及的项目制品。系统步骤中的 `decide`（`rechazado`）和 `quitar`：将被移除的制品。
artifact	string	否	可选，仅适用于带有 .arketum/proyecto.yaml 的项目：未提交清单时，你所询问的制品。没有该字段时，答复为项目状态。使用 `action: deriva` 时，表示限定范围的制品。
borrados	array	否	`close`：该单元删除的文件；在其快照中，这些文件位于所有根目录之外（从项目根目录起算的路径）：条件 5 不会将其计入。
completa	boolean	否	`auditoria`：设为 `true` 时审计所有内容；否则按从新到旧的顺序审计，并跳过自上次关闭的检查以来未变化的内容（邻近项除外）。
continua	string	否	`open`：超出限制的调整（`excede_ajuste`），该单元从此处继续：打开该单元时会将其丢弃，而该单元会继承其快照和策略。
decision	enum	否	`decide`：仅当你的客户端无法询问人员时，填写人员在聊天中给出的决定。绝不能填写你自己的决定。与批次和面板中的四个选项相同：`aprobado`（批准）、`ajustar`（附 `note`）、`rechazado`（拒绝，附 `reason`）和 `no_entiendo`（如有疑问，将问题放在 `note` 中）。最后一项不会批准任何内容，并会返回需要向人员解释的内容。aprobado \| ajustar \| rechazado \| no_entiendo
enmienda	string	否	`bloquear`：人员选择修订该单元定义时（lp-f05），填写其新定义所修订的、正在实施的单元；原因由 Arketum 填写。
evidence	array	否	`submit` 在证据或里程碑步骤中使用：每项证据都要附上要求（`requirement`）及其类别。执行项由你运行，并提供命令、输出、退出码和 `on`（`before`、`change`；针对真实环境运行的内容使用 `entorno`：访问和部署）；报告项提供来源、引用和内容；声明项提供声明者及内容（渠道由 Arketum 填写）。执行项可以声明 `satisfies`：其满足的要求（`<artefacto>:<id>`）。e2e 套件的声明（`salidas/<artefacto>/e2e`）应在 `defectos` 中列出因已报告缺陷而失败的要求。里程碑确认（`despliegue/<entorno>/confirmacion`）是一项不带其他字段的声明：Arketum 会通过交互渠道询问人员是否已部署并运行；执行项或针对该要求的报告可作为可选佐证。
opciones	array	否	`solicitar` 且 `pide: decision` 时：人员作出决定时可选的选项。
optional	array	否	`open` 和 `rescope`：该单元纳入的通道可选步骤。
politica	string	否	`auditoria`：人员指定的安全规则来源（其本人或组织的策略：路径、URL 或名称）；未指定时，每个批次都依据当前通行的通用最佳实践进行评判。
proposal	object	否	可选。起始清单和拟议变更，用于让评审意见区分本次变更引入的问题与原有问题。在一个单元内，基线由 Arketum 确定（使该制品降级的最后一个已关闭单元的级别）：只声明 `deltas`。
proposal.deltas	array	否
proposal.baseline	object	否
proposal.baseline.items	array	是
proposal.baseline.level	enum	是	L0 \| L1 \| L2 \| L3 \| L4
proposal.baseline.artifact	string	否
fronteras	array	否	`close`：根据代码推导出的、有关已触及制品的边界信息，仅供参考：按制品列出新增或变更项（`pone`：`id`、`direccion` 输入/输出、`mecanismo`、`contraparte`、如有则列出 `contrato`，以及代码中的功能项和 `rutas`），已不存在的项（`quita`，列出 ID）或 `ninguna`。
inventory	object	否
inventory.items	array	是
inventory.level	enum	是	L0 \| L1 \| L2 \| L3 \| L4
inventory.artifact	string	否
milestone	object	否	`open`：选择了里程碑步骤时的里程碑：`despliegue`、`entrega` 或 `ejecucion`，以及其详细信息。
milestone.kind	string	是
milestone.detail	string	是
objective	string	否	`open`：希望达成的目标。
requisito	string	否	`solicitar`：请求作出决定的要求（`<artefacto>:<id>`）。`decide`：其 gate 正在作出决定的要求。
veredicto	enum	否	需求关卡中的 `decide`：用户在聊天中的决定（`sin_decidir` 会在未作决定的情况下撤回请求）。绝不能由你决定。conforme \| retirar \| defecto \| decidir \| sin_decidir \| sin_e2e
resolution	object	否	矛盾关卡中的 `decide`：用户如何解决矛盾（哪项优先、哪项撤回、各自在何时有效，或推迟处理）。
resolution.kind	enum	是	precedence \| revoked \| conditional \| deferred
resolution.winner	string	否
resolution.revoked	string	否
resolution.condition	string	否
selfReview	string	否	可选。用于声明原型的自我审查答复，必须严格采用要求的格式。系统会收集、保存到 .arketum/ 并展示该答复。不进行评估，也不会阻止流程：任何答复都不会中断后续步骤。
subagentes	boolean	否	`modo`：你的客户端是否可以委派给子 Agent（由你声明）；如果不声明，Arketum 会依次建议。
veredictos	object	否	带 `step: confirmacion` 的 `decide`：对每个功能项（`<artefacto>:<id>`），填写用户的回答：「si」「no」或「despues」；若有任何一项为「no」，则填写 `porque`。
inventories	array	否	单元内的 `submit`：按顺序提交多个层级，每个层级作为单独交付（包含其 `hereda`、`quitar`、`proposal` 和 `selfReview`）。遇到第一个无法推进的层级时停止。
resumenCada	integer	否	委派中带 `tope: sin_tope` 的 `delegar`：委派下每完成多少个未关闭单元（5、10 或 20，包含授予委派的单元；默认 10），才向批次发送一次仅包含已批准内容的摘要。
retroactiva	object	否	`close`：追溯验证；当该单元包含需求且相关范围内存在更早的其他单元时适用（范围由不带该项的 `close` 给出）。需提供评审者（`revisor`；最好是没有你上下文的子 Agent）、无发现的已评审项，以及 `hallazgos`（需求、类别、原因和 `propuesta`：「nada」或某个单元，并附 `carril` 和 `objetivo`；合并时还需提供 `fusiona` 和 `queda`）。另需提供 `consolidaciones`：分散在多个需求中的一项意图（`intencion`、索引中的 `requisitos`、原因，以及整合后 PRD 的 `propuesta`：`carril`、`objetivo`、可选的 `queda` 和 `separa`）。
retroactiva.revisor	string	是
retroactiva.hallazgos	array	否
retroactiva.revisados	array	否
retroactiva.consolidaciones	array	否
sinRequisito	array	否	`close`：变更未涉及任何需求的受影响项（例如脚手架），每项都需附上原因。
clasificacion	object	否	`open`：相对于需求索引的请求类别，以及请求中提及的索引 ID（`<artefacto>:<id>`）。在需要需求梳理的轨道中必填；用于判断该轨道是否适用。使用 `requisito` 加载候选项详情后再分类。
clasificacion.ids	array	否
clasificacion.clase	enum	是	defecto \| cambio \| nuevo \| choque \| amplia