guanghulab/spec/agent-territory-protocol.hdlp

140 lines
6.1 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ═══════════════════════════════════════
# 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