check

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Check MTHDS bundles

检查MTHDS包

Validate and review MTHDS bundles based on the MTHDS standard without making changes.
基于MTHDS标准验证和审核MTHDS包,不进行任何修改。

Process

流程

Prerequisite: See CLI Prerequisites
  1. Read the .mthds file — Load and parse the method
  2. Run CLI validation (use
    -L
    pointing to the bundle's own directory to avoid namespace collisions):
    bash
    mthds-agent pipelex validate <file>.mthds -L <bundle-directory>/
  3. Parse the JSON output:
    • If
      success: true
      — all pipes validated, report clean status
    • If error — see Error Handling Reference for error types and recovery
  4. Cross-domain validation — when the bundle references pipes from other domains, use
    --library-dir
    (see Error Handling — Cross-Domain)
  5. Analyze for additional issues (manual review beyond CLI validation):
    • Unused concepts (defined but never referenced)
    • Unreachable pipes (not in main_pipe execution path)
    • Missing descriptions on pipes or concepts
    • Inconsistent naming conventions
    • Potential prompt issues (missing variables, unclear instructions)
  6. Report findings by severity:
    • Errors: Validation failures from CLI (with
      error_type
      and
      pipe_code
      )
    • Warnings: Issues that may cause problems (e.g., model availability)
    • Suggestions: Improvements for maintainability
  7. Do NOT make changes — This skill is read-only
前提条件:查看CLI前提条件
  1. 读取.mthds文件 —— 加载并解析方法
  2. 运行CLI验证(使用
    -L
    指向包自身目录以避免命名空间冲突):
    bash
    mthds-agent pipelex validate <file>.mthds -L <bundle-directory>/
  3. 解析JSON输出
    • 如果
      success: true
      —— 所有管道验证通过,报告状态正常
    • 如果出现错误 —— 查看错误处理参考了解错误类型和恢复方法
  4. 跨域验证 —— 当包引用其他域的管道时,使用
    --library-dir
    (查看错误处理 —— 跨域
  5. 分析其他问题(CLI验证之外的人工审核):
    • 未使用的概念(已定义但从未引用)
    • 不可达管道(不在main_pipe执行路径中)
    • 管道或概念缺少描述
    • 命名约定不一致
    • 潜在的提示问题(缺少变量、指令不清晰)
  6. 按严重程度报告发现的问题
    • 错误:CLI返回的验证失败结果(包含
      error_type
      pipe_code
    • 警告:可能引发问题的情况(例如,模型可用性问题)
    • 建议:可提升可维护性的改进方案
  7. 请勿修改文件 —— 本技能为只读模式

What Gets Checked

检查内容

  • TOML syntax validity
  • Concept definitions and references
  • Pipe type configurations
  • Input/output type matching
  • Variable references in prompts
  • Cross-domain references
  • Naming convention compliance
  • Model preset resolution (dry run)
  • TOML语法有效性
  • 概念定义与引用
  • 管道类型配置
  • 输入/输出类型匹配
  • 提示中的变量引用
  • 跨域引用
  • 命名约定合规性
  • 模型预设解析(试运行)

Reference

参考资料

  • CLI Prerequisites — read at skill start to check CLI availability
  • Error Handling — read when CLI returns an error to determine recovery
  • MTHDS Agent Guide — read for CLI command syntax or output format details
  • MTHDS Language Reference — read when reviewing .mthds TOML syntax
  • Native Content Types — read when checking
    $var.field
    references in prompts to verify the attribute exists on the content type
  • CLI前提条件 —— 在技能启动时查看,检查CLI是否可用
  • 错误处理 —— 当CLI返回错误时查看,确定恢复方法
  • MTHDS Agent指南 —— 查看CLI命令语法或输出格式详情
  • MTHDS语言参考 —— 审核.mthds TOML语法时查看
  • 原生内容类型 —— 检查提示中的
    $var.field
    引用时查看,验证内容类型上是否存在该属性