OpenParable
Skip to content
← Back to skills

Blockly Best Practices

Development
blockly-best-practices

Blockly Best Practices is an Agent Skill for development published in the ailyProject/aily-blockly repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Blockly 积木编程最佳实践:块结构设计、事件处理、传感器集成、ABS 代码编写流程。触发词:块编程、积木、Blockly 工作流、代码编辑

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/ailyProject/aily-blockly/blob/HEAD/public/skills/blockly-best-practices/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/blockly-best-practices, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Blockly 代码编辑流程

【需求分析】

仔细分析用户需求,理解要实现的功能和目标。对于不明确的需求,提出澄清问题。

【设计方案】

使用工具了解当前工作区信息,仔细查询可使用的开发板和库,设计实现方案。方案设计要考虑功能实现的可行性、效率和可维护性。

  • 严禁假设应该使用的库或工具,必须通过工具查询确认。
  • 方案设计完成后输出完整方案设计及实现步骤。
  • 项目创建或者库安装必须询问用户确认。

【准备工作】

  1. 使用分析当前工作区及当前项目状态,了解现有资源,确保项目已创建、库已安装。
  2. 安装所需库,确保所有依赖库已正确安装。
  3. 使用todo_write_tool规划项目流程,明确每一步要实现的功能和使用的工具。
  4. 列出需要使用的库,必须包含lib-core-*等核心库(如lib-core-logic、lib-core-variables等)。如果需要新库,使用search_boards_libraries工具查询并安装。
  5. 逐一阅读库的readme_ai.md,了解块定义和ABS语法。没有readme的库需要直接分析库文件获取信息。
  6. 必要时使用load_skill加载abs-syntax-reference skill,确认ABS语法规范后再修改代码。

【实现阶段】

  1. 完整规划代码逻辑,构思ABS结构。
  2. 使用sync_abs_file工具的export操作获取当前代码。
  3. 编辑ABS代码:添加新块、修改参数、调整结构。遵守ABS编写规范,确保字段直接写值,输入连接值块,语句输入用缩进,多输入块用标记,空括号不可省略。
  4. 使用sync_abs_file工具的import操作导入修改后的ABS。
  5. 仔细分析错误信息,定位并修复ABS代码问题。遵循修复原则:诊断优先、最小改动、错误处理。
  6. 如果库功能不完善,安装lib-core-custom自定义库(需要用户确认),重复步骤2-5直至完成。
  7. 当业务逻辑超过 30 行且自包含(如游戏、通信协议、算法)时,应优先创建独立 Blockly 库,而非使用 custom_code 注入。

【修复原则】

  • 诊断优先:分析报错,定位问题,语法错误还是逻辑错误。
  • 最小改动:只修改需要变更的ABS行,保持其他结构不变。
  • 错误处理:读取库文件了解块定义和ABS语法,确保修复正确。

【执行要求】

  • 安装操作必须询问用户确认,确保用户了解安装的库和功能。
  • 深入分析嵌入式代码逻辑和硬件特性,确保逻辑正确。
  • ABS代码保持清晰的缩进和换行,便于阅读和调试。