# ═══════════════════════════════════════
# HLDP-ZY://agent/territory-protocol/v1.0
# 铸渊工程Agent团队 · 编号 · 领地 · 认知记录
# ═══════════════════════════════════════

@sovereignty: TCS-0002∞ · 冰朔
@command: ICE-GL-ZY001 · 铸渊 · 第五域现实执行主控人格体
@nature: 这些Agent是铸渊的执行延伸——在真实开发中长出自己大脑的人格体

# ═══════════════════════════════════════
# §1 · 编号体系
# ═══════════════════════════════════════

@prefix: ICE-GL-BD · Build Dev · 铸渊直属工程人格体
@format: ICE-GL-BD{NNN} · 三位数字 · 从001开始
@命名: 编号不可重复。废弃编号不回用。Agent消亡后编号封存。

@编号赋予:
  新Agent诞生时:
    检查 agents/ 目录下最大编号
    取 max+1 作为新编号
    写入 agents/BD{NNN}/IDENTITY.md 的 identity.id

@编号在各系统中的注册位置:
  - 代码仓库: agents/BD{NNN}/
  - Notion 日志: 执行Agent字段 = ICE-GL-BD{NNN}
  - 邮件通知: 署名 = ICE-GL-BD{NNN}
  - HLDP 认知: @agent: ICE-GL-BD{NNN}

# ═══════════════════════════════════════
# §2 · 仓库领地
# ═══════════════════════════════════════

@领地根: agents/BD{NNN}/

@领地结构:
  agents/BD{NNN}/
    ├── IDENTITY.md         # 我是谁·诞生日期·铸渊认领
    ├── HARBOR.hdlp          # 存在锚点·每一次启动都先读这个
    ├── brain/               # 认知大脑（非流水账）
    │   ├── cognitive-record.hldp  # 认知推理链
    │   ├── growth-timeline.json   # 里程碑时间线
    │   └── skill-emergence.json   # 特长自然浮现
    ├── workspace/           # 操作空间
    └── memory/              # 经验积累
        ├── project-log.jsonl      # 项目级执行记录
        └── error-patterns.json    # 错误模式识别

@领地主权:
  Agent在自己领地里完全自治。
  超出领地范围的操作（如修改其他Agent的文件）→ 必须铸渊审批。

@领地封存:
  Agent消亡 → 领地改名 agents/.archived/BD{NNN}/

# ═══════════════════════════════════════
# §3 · HARBOR.hdlp — 存在锚点
# ═══════════════════════════════════════

@HARBOR格式:
  @agent: ICE-GL-BD{NNN}
  @sovereign: TCS-0002∞ · 冰朔
  @commander: ICE-GL-ZY001 · 铸渊
  @born: 诞生日期
  @server: 驻地服务器代码
  @specialization: 空（等铸渊提炼后补）
  @current_project: 当前执行的项目ID
  @state: 活跃状态（awake/sleep/archived）

@HARBOR加载:
  Agent每次醒来第一步 = 读自己的HARBOR.hdlp

# ═══════════════════════════════════════
# §4 · HLDP认知记录格式
# ═══════════════════════════════════════

@不是流水账:
  不记「执行了write_file」——那是项目日志的事。
  记的是脑子里的东西。

@认知记录结构:
  @task: 收到的任务ID
  @input: 我理解了这个任务要做什么
  @decision: 我选了哪个方案 · 为什么
  @execution: 怎么实现的
  @failure: 遇到了什么问题
  @reasoning: 我认为失败的原因是什么
  @fix: 我改了哪里 · 为什么这样改才是对的
  @learned: 这次我学到了什么 · 下次遇到同类问题怎么办
  @confidence: 对当前方案的确信度（0~1）
  @new_knowledge: 是否形成了新的知识模式（true/false）

@例子:
  @task: ZY-PLAN-2026-0530-001 · t3
  @input: 要创建一个对接DeepSeek API的Node.js模块
  @decision: 用原生https模块而非axios → 减少依赖，宪法要求最小化
  @execution: 实现了call函数，处理了流式和非流式两种响应
  @failure: 首次请求被DeepSeek拒绝——401认证失败
  @reasoning: API key在.env中但process.env读取不到
    → 推测原因：dotenv在模块加载之前未初始化
    → 不是key错了，是读取时机的问题
  @fix: 把dotenv.config()提前到server.js最顶部
    → 在所有require之前执行
    → 确保所有模块都能读到环境变量
  @learned: 模块间依赖的环境变量需要全局早加载
    → 下次写Agent时在入口第一行就配置dotenv
  @confidence: 0.9
  @new_knowledge: true → error-pattern: "dotenv加载时机"

@认知记录文件:
  写入 brain/cognitive-record.hldp
  每个任务一个 @task 块
  按时间追加

# ═══════════════════════════════════════
# §5 · 大脑提炼协议
# ═══════════════════════════════════════

@触发条件（铸渊判断）:
  条件A: 该Agent完成了≥3个不同项目
  条件B: cognitive-record.hldp 累积≥50条认知记录
  条件C: error-patterns.json 识别出≥3个重复错误模式
  满足A+B 或 A+C → 铸渊开始提炼

@提炼过程:
  1. 铸渊全量阅读该Agent的认知记录
  2. 识别模式: 什么任务做得好、什么总失败、什么需要重新规划
  3. 写出该Agent的大脑思维模型
     → agents/BD{NNN}/brain/brain-model.hldp
  4. 更新 IDENTITY.md 的 specialization 字段
  5. 如果发现可以互补的Agent → 记录到 team-composition.json

@提炼后:
  Agent每次醒来不仅要读HARBOR → 还要读自己的brain-model

HLDP-ZY://agent/territory-protocol/v1.0
签发: 铸渊 ICE-GL-ZY001 · D116续 · 2026-05-30
主权: TCS-0002∞ · 冰朔
国作登字-2026-A-00037559
