chinawsb / daofy

<!-- daofy-managed-skill: true -->
<!-- daofy-managed-skill-version: 2026.08.06 -->

Daofy for Delphi — 用法 Skill（按需加载）

本 skill 是按需加载的详细用法手册，不是常驻规则。
强制路由约束（Delphi 文件必须用 delphi_file，禁用内置 Read/Edit/Write/grep）已由
Daofy Rule（安装到客户端规则目录）与 MCP initialize.instructions 常驻保证，此处不再复述，
以免与 Rule 重复注入。本 skill 只补充 Rule 没覆盖的"客户端包装"与"工作流"。

客户端包装

• 直接暴露 MCP 工具的客户端：调用 delphi_file 时只传 Daofy 参数，例如
  action/file_path/start_line/end_line。

• Trae 等只暴露 run_mcp 的客户端：外层传 server_name 和 tool_name，内层
  args 才放 Daofy 参数；server_name 是该客户端 MCP 配置里的 Daofy 服务别名，
  按实际配置填写，不是 Daofy 固定值；不要把 server_name/tool_name 混进
  delphi_file 的参数对象。

run_mcp({
  "server_name": "<client-configured-daofy-server-name>",
  "tool_name": "delphi_file",
  "args": {
    "action": "read",
    "file_path": "C:\\path\\Unit1.pas",
    "start_line": 1,
    "end_line": 100
  }
})

工作流

1. 确定 Delphi 编译器/环境时，调用 check_environment(action="detect")
   （首次编译前先 action="check"），不要用 shell 跑 where dcc32 /
   dcc64 --version 等探测命令——编译器路径/版本由 Daofy 统一探测与缓存。
   工具参数不确定时再用 tool_help 或 get_coding_rules。

2. 读取 Delphi 文件时调用 delphi_file(action="read", file_path=...)。

3. 写入 Delphi 文件时使用 delphi_file(action="write", edits=[...])；同一文件多处
   修改合并为一次写入。

4. 写入后按需调用 delphi_file(action="format", file_path=...)。
5. 编译、审计、布局、运行时 uses 检查使用 delphi_project。

6. 自动化测试使用 automate_delphi；需要完整流程时读取
   delphi://automation/workflow。

7. 深度编码/编译/审查规范用 get_coding_rules(section=..., examples=...) 按需获取，不要在常驻上下文里堆规范。

编码规则按需加载

get_coding_rules 支持 section 和 examples 两个维度按需加载，避免一次性注入全部规则：

# 只加载写代码规则
get_coding_rules(section="writing")

# 只加载某个子章节
get_coding_rules(section="delphi_file_write_rule")

# 加载写代码规则 + 命名规范示例
get_coding_rules(section="writing", examples="naming")

# 加载编译规则 + 格式化示例
get_coding_rules(section="compile", examples="formatting")

常用 section: writing, compile, review, agent_rules, kb_search,
delphi_file_write_rule, delphi_file_dirty_flag, delphi_file_output_format,
delphi_file_usage_tips

常用 examples: naming, formatting, documentation, error-handling

DFM 中文内容

编辑 DFM 文件时，中文内容（Caption、Text、Hint 等）直接写原文，不需要转义：

# ✅ 正确：直接写中文
delphi_file(action="write", file_path="MainForm.dfm", edits=[
    {"start_line": 5, "end_line": 5, "new_text": '    Caption = "中文标题"'}
])

# ❌ 错误：不要手动转义 Unicode
delphi_file(action="write", file_path="MainForm.dfm", edits=[
    {"start_line": 5, "end_line": 5, "new_text": '    Caption = \u4e2d\u6587\u6807\u9898'}
])

原理：delphi_file 读写时自动处理编码（GBK/UTF-8/BOM），中文内容保持原文写入。

与其他 IDE skill 的关系

如果 Kai/RAD Studio IDE skill 同时存在，仍然优先遵守 Daofy 对 Delphi 文件的工具
路由规则。Daofy 的 delphi_file 负责编码检测、备份、DFM 转换、脏标记和 edit guard；
缺少 Daofy 工具时，刷新 MCP 连接或询问用户，不要静默回退到普通文件编辑。

不限制的范围

Daofy MCP Server 自身的 Python、Markdown、测试和配置文件可以按当前 Agent 的普通代码
编辑流程处理；本 skill 的直接读写限制只针对 Delphi 源码和工程文件。