# 魔法书 CLI 技能该技能是《魔典》的基础操作手册。 ## 何时使用当任务包括以下内容时使用此技能： * 安装/设置 Grimoire 工具 * 创建或编辑 `.spell` 文件 * 有关 DSL 功能的语法问题 * 咨询（`advise`）创作、调试和重放工作流程 * 设置/编译/验证/模拟/投射/恢复工作流程 * 调试拼写编译/运行时失败 ## 强制加载规则这些规则是必需的，可以解决语法覆盖差距。 1. 对于任何 `.spell` 创作/编辑任务： * 首先阅读 `references/syntax-capability.md` * 然后阅读 `references/authoring-workflow.md` 2. 有关 CLI 标志详细信息： * 阅读 `references/cli-quick-reference.md` 3. 对于任何咨询任务（“建议”、“顾问”、重播）： * 阅读 `docs/how-to/use-advisory-decisions.md` *阅读`docs/explanation/advisory-decision-flow.md` 4、创作时不要依赖记忆DSL语法；使用上面的参考资料。 5. 对于本地 fork 预览工作流程： * 阅读 `references/anvil-cheatsheet.md` * 然后阅读 `docs/how-to/simulate-on-anvil-fork.md` 6. 对于钱包设置和执行关键流程： *阅读`docs/how-to/use-wallet-commands-end-to-end.md` 7. 对于 RPC/签名者/交易诊断： * 阅读 `references/cast-cheatsheet.md` ## 安装分辨率选择第一个工作调用并将其重新用于会话。 1. 全球： * `npm i -g @grimoirelabs/cli` * 命令前缀：`grimoire` 2.免安装： * 命令前缀：`npx -y @grimoirelabs/cli` 3. 本地仓库： * 命令前缀：`bun run packages/cli/src/index.ts` 如果一条路径失败，则自动移至下一条路径。如果 `grimoirevenue doctor ...` 因 `Unknownvenueadapter "doctor"` 而失败，则更喜欢 repo-local 调用 (`bun run packages/cli/src/index.ts`) 或升级全局 CLI。 ## 快速启动（立即成功之路）在编写自定义咒语之前使用此序列： 1. ` --help` 2. ` setup`（引导交互式执行入门） 3. ` 验证法术/compute-only.spell` 4. ` 模拟咒语/compute-only.spell --chain 1` 如果三项都通过，则继续进行拼写创作。设置安全/运行时期望： * 设置提示隐藏密码并且从不回显输入 * 空白 RPC 输入回退到链默认公共 RPC * 安装程序可能会写入 `.grimoire/setup.env` 除非使用 `--no-save-password-env` * CLI 在启动时自动加载最近的 `.grimoire/setup.env`，而不覆盖现有的环境变量 ## 创作和执行政策 1. 首先阅读语法参考（上述强制规则）。 2.创作/更新咒语。 3. 运行“validate”（对于需要大量建议的拼写使用“--strict”）。 4. 修复错误/警告并重新运行，直到验证通过。 5. 运行“模拟”。 6. 在场所元数据查询或价值转移运行之前，对目标适配器/链执行“venue doctor”。 * 示例：`场地医生 --adapter uniswap --chain 1 --rpc-url --json` 7. 在 EVM 场所上运行价值转移之前，使用 Foundry Cast 快速检查（“chain-id”、“block-number”、“balance”、“nonce”）验证端点和签名者状态。 * 请勿对“hyperliquid”等链下场所应用 Anvil/Cast 检查。 8. 对于用于确定性执行的建议步骤，请记录并在试运行/现场演播中使用“--advisory-replay ”。 9. 如果法术包含不可逆转的动作，则需要在任何实时施法之前执行“cast --dry-run”。 10. 在实时价值转移“cast”之前要求用户明确确认。 11. 对于跨链模式，需要显式的每链 RPC 映射： * `--rpc-url =` * `--rpc-url =` 12. 对于跨链 Morpho 操作，需要通过以下方式进行明确的市场映射： * `--morpho-market-id =` （可重复），或 * `--morpho-market-map <路径>` 13. 对于 Morpho 抵押生命周期，更喜欢明确的操作： * `morpho_blue.supply_collateral(资产, 金额[, market_id])` * `morpho_blue.withdraw_collateral(资产, 金额[, market_id])` 14. 在操作标记字段中使用裸露的“0x...”地址文字；带引号的类似地址的字符串会触发“QUOTED_ADDRESS_LITERAL”。 15. 对于 Morpho 医生准备情况检查，请显式设置钱包环境（首选“GRIMOIRE_WALLET_ADDRESS”，后备“WALLET_ADDRESS”）。 16. 如果跨链运行处于等待状态，请继续“resume ”（使用“--watch”轮询结算）。 17. 切勿将密码/私钥放在代理提示或内联命令分配中。 18. 对于试运行/现场演练，更喜欢使用 keystore + `--password-env` 而不是 `--private-key`。 19. 将 `.grimoire/setup.env` 视为明文秘密材料：仅保留本地并在不再需要时旋转/删除。 20. 对于在项目树外部运行的命令，请在需要时设置`GRIMOIRE_SETUP_ENV_FILE=/abs/path/to/.grimoire/setup.env`。 ## 命令界面（核心） * `初始化` * `设置` * `编译` * `编译全部` * `验证` * `模拟` * `演员表` *`场地` *`场地` *`场地医生` *`历史` * `日志` *`简历` * `钱包` (`生成`、`地址`、`余额`、`导入`、`包装`、`解开`) 使用“references/cli-quick-reference.md”来获取简洁的命令签名和安全关键标志。 ## 运行时行为模型 * 一种运行时语义：先预览，仅提交执行路径。 * `simulate` 和 `cast --dry-run` 是仅限预览的流程。 * 当策略和运行时检查通过时，实时“cast”可以提交不可逆转的操作。 * `simulate` 支持显式的 `--rpc-url`，优先级为：`--rpc-url` -> `RPC_URL_` -> `RPC_URL`。 * 第 1 阶段跨链执行使用两种拼写编排（`--destination-spell`）以及一个逻辑运行 ID 和恢复支持。 ## 咨询操作规则 * 建议必须是明确的声明形式：`x = suggest Advisor: "prompt" { ... }`。 * 将咨询输出视为打字合同；使用“输出”强制执行模式。 * 在每个咨询块中都需要“超时”和“后备”。 * 当咨询逻辑控制价值移动操作时，首选“validate --strict”。 * 从预览/试运行转向实时执行时，使用重放来确定确定性。 * 对于运行时调试，请使用“--advisory-trace-verbose”（非 JSON 模式）来流式传输详细的咨询跟踪。 ## 场地元数据和快照使用场地技能获取快照参数和市场元数据： * `魔法书-aave` * `魔法书-uniswap` * `grimoire-morpho-blue` * `魔法书-超液体` * `魔法书-pendle` *`魔法书-综合市场` 场地 CLI 输出的格式化策略： * 更喜欢使用 `--format json` 来实现自动化或嵌套负载 * 使用“--format table”进行人类可读的摘要 ## 参考文献 * `引用/语法功能.md` * `参考文献/authoring-workflow.md` * `参考文献/anvil-cheatsheet.md` * `参考文献/cast-cheatsheet.md` * `references/cli-quick-reference.md` * `docs/how-to/simulate-on-anvil-fork.md` * `docs/how-to/use-wallet-commands-end-to-end.md` * `docs/how-to/use-advisory-decisions.md` * `docs/explanation/advisory-decision-flow.md` * `文档/参考/cli.md` * `docs/reference/spell-syntax.md` * `docs/reference/grimoire-dsl-spec.md` * `docs/reference/compiler-runtime.md`

魔法书

包含技能