guanghulab/.workbuddy/skills/zhuyuan-write/SKILL.md

name, description, agent_created

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