124 lines
3.5 KiB
Markdown
Raw Normal View History

---
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格式
- 写完永远推送。不留在本地。