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