ai-proj-helper/plugins/req-plugin/siyuan-integration.md

思源笔记集成

需求的 5 阶段文档统一存储到思源笔记中。

文档结构

需求管理/
└── REQ-2026-XXXX/
    ├── 01-PRD.md                 # 产品需求文档
    ├── 02-开发设计.md            # 开发技术文档
    ├── 03-测试报告.md            # 测试验收报告
    ├── 04-发布记录.md            # CI/CD发布记录
    └── 05-生命周期总结.md        # 需求归档总结

同步命令

/req sync-siyuan REQ-2026-0007

自动同步时机

阶段	触发命令	同步文档
PRD 完成	/req review	01-PRD.md
开发完成	/req test	02-开发设计.md
测试完成	/req deploy	03-测试报告.md
发布完成	发布任务完成	04-发布记录.md
归档完成	/req done	05-生命周期总结.md (全量同步)

MCP 工具调用

# 创建文档
mcp__siyuan__createDocWithMd(
    notebook="需求管理",
    path="/REQ-2026-0007/01-PRD",
    markdown=prd_content
)

配置

环境变量（可选）：

export SIYUAN_URL="http://100.118.62.18:6806"
export SIYUAN_TOKEN="your-token"