Hizal Write — Hizal 写作

作为你构建的同时写作。不是可选的。 可用的写作工具 你正在写什么 工具 范围 个人观察或经验教训 hizal__write_memory AGENT 架构或设计决策 hizal__write_knowledge 项目 代码库遵循的约定 hizal__write_convention 项目（自动注入） 代理身份或个性 hizal__write_identity AGENT（自动注入） 组织范围的知识 hizal__write_org_knowledge 组织 原则（需要人工推广） hizal__store_principle 组织 自定义块类型 hizal__write_chunk 不同 不要使用 hizal__write_context —— 它已经过时。使用上述专用工具。

通过 write_chunk 自定义块类型 对于内置工具未涵盖的块类型，请使用 hizal__write_chunk。块类型可以根据组织进行自定义——在假设某种类型不存在之前，请始终发现可用的类型。 发现可用的类型 hizal__list_chunks() # 检查结果中的 chunk_type 值 或者检查项目的 AGENTS.md 以获取组织的类型约定。

用法 hizal__write_chunk（ type = ""， query_key = ""， title = ""， content = ""， scope = "PROJECT"，# 或 AGENT，ORG project_id = ""，# PROJECT 范围所需 org_id = ""，# ORG 范围所需 agent_id = "" # AGENT 范围所需 ） write_chunk 接受与所有其他写作工具相同的公共字段（query_key、title、content、gotchas、related、source_file、inject_audience 等）。它还接受自定义字段以进行类型特定的元数据。

何时使用 write_chunk 与内置工具 内置工具 —— 在内容清晰映射到 MEMORY、KNOWLEDGE、CONVENTION、IDENTITY、ORG_KNOWLEDGE 或 PRINCIPLE 时使用 write_chunk —— 用于任何自定义组织类型（例如 SPEC、RUNBOOK、ADR、INVESTIGATION） 如果有疑问，请检查组织定义的块类型并选择最接近的匹配

一次写入一个块 不要将所有内容批量写入一个块中。边做边写： 做出了架构决策？→ 现在写入知识 了解了代码库约定？→ 现在写入约定 发现了有用的个人经验？→ 现在写入记忆 发现了更合适的自定义类型？→ 现在写入块

公共字段 所有写作工具接受： query_key —— 此主题的唯一键（启用后续的精确查找） title —— 短描述标题 content —— 全部内容 source_file / source_lines —— 内容来源 gotchas —— 警告或陷阱列表 related —— 相关 query_keys 列表 inject_audience —— 自动注入的 DNF 目标规格（省略默认值）

示例 hizal__write_knowledge（ project_id = ""， query_key = "nuvei-webhook-signing"， title = "DMN Webhook 签名验证"， content = "所有 DMN 负载都使用 SHA-256 HMAC 进行验证。校验和是从排序后的键值对 + 商家密钥计算得出。请参阅包 internal/checksum 的实现。"， related = ["nuvei-payload-structure"， "merchant-credentials"]， gotchas = ["Never use /payment for credential verification"] ）

推广 AGENT → PROJECT 如果个人记忆块对团队有广泛的用途，请推广： 使用 hizal__read_context 读取块 将其写回为 write_knowledge 或 write_convention，内容可选 使用 hizal__delete_context 删除原始 AGENT 块（可选）