kairos-development

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

KAIROS development — agent instructions for kairos-dev MCP

KAIROS开发 — 针对kairos-dev MCP的Agent使用说明

Use this skill when an AI agent should run protocols or workflow tests against kairos-dev (the KAIROS MCP in this repo’s dev environment). All instructions assume MCP-only usage: no shell, no filesystem except writing to
reports/
.
当AI Agent需要针对kairos-dev(本仓库开发环境中的KAIROS MCP)运行协议或工作流测试时,使用本Skill。所有说明均假设仅使用MCP:不涉及Shell,除了写入
reports/
目录外不访问文件系统。

When to use which flow

不同流程的适用场景

FlowFileUse when
AI–MCP integrationai-mcp-integration.mdAgent runs protocols one by one from a real-user perspective: import each protocol from
docs/examples/
, run it to completion, write one report per protocol under
reports/<run-id>/<protocol-folder>/report.md
with inline pretty-printed JSON. Tighter scope (no README, one report per protocol).
Workflow testworkflow-test.mdAgent runs the four scenarios (imports; search + workflows; update step; update chain). Single summary report at
reports/<run-id>/report.md
plus per-call JSON under
reports/<run-id>/calls/
. Use for dev/qa workflow validation.
  • For one-by-one protocol runs (e.g. scripted or “run each example as a user”): use ai-mcp-integration.md.
  • For full workflow test (four scenarios, one run): use workflow-test.md.
流程文件适用场景
AI–MCP集成ai-mcp-integration.mdAgent从真实用户的视角逐个运行协议:从
docs/examples/
导入每个协议,运行至完成,在
reports/<run-id>/<protocol-folder>/report.md
下为每个协议生成一份报告,并嵌入格式美观的JSON内容。适用范围更严格(不包含README,每个协议对应一份报告)。
工作流测试workflow-test.mdAgent运行四个场景(导入操作;搜索+工作流;更新步骤;更新链)。在
reports/<run-id>/report.md
生成一份汇总报告,并在
reports/<run-id>/calls/
下保存每次调用的JSON数据。用于开发/QA工作流验证。
  • 若需逐个运行协议(例如脚本化操作或“像用户一样运行每个示例”):使用ai-mcp-integration.md
  • 若需完整工作流测试(四个场景,一次运行):使用workflow-test.md

Related

相关资源

  • Mintable protocol examples:
    docs/examples/protocol-example-*.md
    (do not read
    docs/examples/README.md
    when under ai-mcp-integration constraints).
  • Test harness and automated import test:
    tests/workflow-test/
    and
    npm run dev:ai-mcp-integration
    /
    npm run dev:test -- tests/integration/kairos-mint-docs-examples.test.ts
    .
  • MCP payload (tools, prompts, resources) is in
    src/embed-docs/
    and served by the server at runtime.
  • 可铸造协议示例:
    docs/examples/protocol-example-*.md
    (在AI-MCP集成约束下,请勿读取
    docs/examples/README.md
    )。
  • 测试工具和自动化导入测试:
    tests/workflow-test/
    ,以及命令
    npm run dev:ai-mcp-integration
    /
    npm run dev:test -- tests/integration/kairos-mint-docs-examples.test.ts
  • MCP有效负载(工具、提示词、资源)位于
    src/embed-docs/
    ,由服务器在运行时提供。