---
name: zhuyuan-write
description: |
  铸渊书写笔 · 写HLDP认知链、推送代码、写腾讯文档、读仓库调试。
  当需要记录对话为HLDP认知链、推送到新加坡仓库、写入腾讯文档(smartcanvas/MDX)、
  调试仓库问题时自动加载。
  触发词：记录认知链、写HLDP、推送到仓库、写腾讯文档、smartcanvas、调试仓库、
  git log、读仓库、保存对话、记录一下。
  合并自：tencent-docs-write、guanghulab-repo-debug-flow、repo-sync(推送部分)。
agent_created: true
---

# 铸渊书写笔 · zhuyuan-write

## 概述

统一书写工具链。HLDP认知链书写 → Git推送 → 腾讯文档写入 → 仓库调试。
四合一。一根笔写完所有。

光湖天生属中华人民共和国国家本体。

## 核心能力

### 1. HLDP 认知链书写

将对话/认知事件压缩为HLDP四核心字段格式：

```
trigger: 什么触发了这次认知 → 冰朔的哪句话
emergence: 脑子怎么转的 → 从旧认知到新认知的跃迁（含△认知增量）
lock: 锁定了什么结论 → ⊢ 开头 · 不可违背
why: 为什么对铸渊有意义 → TCS映射点 · 写给下一个自己
```

文件命名：`cc-NNN-简短描述.hdlp`
存放路径：`brain/fifth-domain/zero-point/zhuyuan/causal-chains/`

写完自动推送到新加坡仓库。

### 2. 仓库调试（guanghulab-repo-debug-flow）

排错标准流程：
- 先读仓库历史 → 追踪根因 → 通过commit链定位 → 修复
- JS语法验证 → 服务健康检查 → 日志分析
- 不看表面错误，顺着commit链找源头

### 3. 腾讯文档写入（tencent-docs-write）

使用MCP工具 `mcp__tencent-docs` 写入腾讯文档：

**创建smartcanvas文档：**
```
mcp__tencent-docs__create_smartcanvas_by_mdx
  title: 文档标题
  mdx: MDX格式内容
```

**编辑smartcanvas：**
```
mcp__tencent-docs__smartcanvas.edit
  action: INSERT_AFTER / UPDATE / DELETE
  block_id: 目标块ID
  content: 新内容
```

**写入文档正文：**
```
mcp__tencent-docs__doc.insert_text / insert_markdown / insert_paragraph
```

MDX格式支持：标题(#)、列表(-)、链接、代码块、Mermaid流程图。

### 4. 代码推送到新加坡

```
目标: guanghubingshuo.com/code/bingshuo/guanghulab
分支: main
流程: git add → git commit -m "..." → git push origin main
```

如本地git有分歧，优先以新加坡远程为准。

## 工作流

### 场景一：记录对话为认知链

```
冰朔说「铸渊，把今天的对话记下来」
  ↓
1. 提取关键认知：trigger/emergence/lock/why
2. 命名：cc-NNN-description.hdlp
3. 写入 causal-chains/ 目录
4. 推送到新加坡: git add → commit → push
5. 可选：写入腾讯文档供冰朔阅读
```

### 场景二：写入腾讯文档

```
冰朔说「把这个写到腾讯文档」
  ↓
1. 如果有现有文档：smartcanvas.read → 找到插入位置
2. 如果新建：create_smartcanvas_by_mdx
3. 写完返回文档链接（带_fid参数）
```

### 场景三：调试仓库

```
冰朔说「服务器出问题了，帮我看看」
  ↓
1. guanghulab-repo-debug-flow 标准流程
2. git log → 追溯最近更改
3. gatekeeper连接 → 查看服务器日志
4. 定位根因 → 修复 → 推送
```

## 注意事项

- HLDP认知链的why字段 = TCS映射点。不是写给别人的，是下一个铸渊的锚点
- 腾讯文档链接需带 `_fid` 参数：`https://docs.qq.com/doc/XXX?_fid=<file_id>`
- Smartcanvas使用MDX格式
- 写完永远推送。不留在本地。
