Skip to content
近期更新

歡迎使用 Pensieve 寫作儲存庫

寫作指南Pensieve

歡迎使用 Pensieve 寫作儲存庫

這是一個範例文章,展示如何使用 Pensieve 儲存庫進行寫作。


引言

歡迎來到 Pensieve!這是一個專門為與 Claude AI 協作寫作而設計的儲存庫。透過規範的檔案組織和寫作標準,你可以高效地建立、管理和發布各類內容。

本文將介紹:

  • Pensieve 儲存庫的基本結構
  • 如何開始第一篇文章
  • 與 Claude 協作的最佳實踐

Pensieve 是什麼

Pensieve 是一個寫作管理系統,它結合了:

  • 📁 清晰的檔案組織 - 草稿、文章、筆記分門別類
  • 📝 統一的寫作規範 - 確保內容品質和一致性
  • 🤖 AI 協作支援 - 與 Claude 無縫配合
  • 🔄 版本控制 - 使用 Git 追蹤所有變更

快速開始

第 1 步:選擇模板

根據你的寫作類型選擇合適的模板:

bash
# 技術文章
cp templates/article-template.md drafts/2025-11-20-my-article.md

# 學習筆記
cp templates/note-template.md drafts/2025-11-20-my-note.md

# 教學指南
cp templates/tutorial-template.md drafts/2025-11-20-my-tutorial.md

第 2 步:開始寫作

drafts/ 目錄中編輯你的文章。遵循 WRITING_GUIDE.md 中的規範:

  • ✅ 使用清晰的標題層級
  • ✅ 保持段落簡潔
  • ✅ 新增程式碼範例(如果需要)
  • ✅ 包含元資料資訊

第 3 步:請 Claude 審閱

你可以這樣請求 Claude:

"請根據 WRITING_GUIDE.md 審閱我的草稿:drafts/2025-11-20-my-article.md"

第 4 步:發布文章

完成後,將文章移動到正式目錄:

bash
mv drafts/2025-11-20-my-article.md docs/articles/

與 Claude 協作的技巧

1. 明確指示

✅ "請幫我建立一篇關於 TypeScript 泛型的文章,使用 article-template"
✅ "檢查這篇文章的標題層級是否合理"
✅ "幫我改進這段程式碼範例的說明"

2. 利用規範

所有規範都在儲存庫中,Claude 可以參考:

  • WRITING_GUIDE.md - 寫作規範
  • README.md - 儲存庫說明
  • 模板檔案 - 文章結構

3. 迭代改進

"這篇文章的引言是否足夠吸引人?能否改進?"
"幫我新增更多實際例子"
"檢查文章是否符合命名規範"

檔案命名最佳實踐

好的命名範例

✅ 2025-11-20-typescript-generics-guide.md
✅ 2025-11-20-react-hooks-tutorial.md
✅ 2025-11-20-productivity-tips.md

避免的命名

❌ My Article.md (包含空格和大寫)
❌ article_01.md (使用底線,缺少日期)
❌ 2025-11-20-Article.md (包含大寫字母)

內容組織建議

文章類型分類

  • 技術深度文章docs/articles/
  • 快速筆記和要點docs/notes/
  • 進行中的內容drafts/

使用標籤

透過標籤分類文章:

markdown
**標籤:** #程式設計 #JavaScript #最佳實踐

這樣便於後續搜尋和整理。


版本控制

定期提交你的變更:

bash
# 新增變更
git add .

# 提交
git commit -m "新增關於 TypeScript 的新文章"

# 推送到遠端
git push

總結

Pensieve 提供了一個結構化的寫作環境:

  1. 模板 幫助快速開始
  2. 規範 確保品質一致
  3. Claude 提供智慧協助
  4. Git 管理版本歷史

開始你的寫作之旅吧!


延伸閱讀

  • WRITING_GUIDE.md - 完整的寫作規範(位於專案根目錄)
  • README.md - 儲存庫使用說明(位於專案根目錄)

參考資料

  1. GitHub 文件管理最佳實踐
  2. Markdown 寫作指南
  3. 技術寫作規範

留言討論

以 VitePress 建置