docgen:文檔工坊技能包

在 DeepSeek Harness(DSH)的工作流中,文檔編寫、變更日誌整理以及代碼審查往往是重複且耗時的環節。docgen 插件爲 DSH 提供了一套文檔工坊技能包,包含 README 生成、PR 描述生成、變更日誌生成和代碼審查等純提示詞 Agent Skills。

該插件由 JohnXu22786 維護,採用 MIT 許可證。它解決了開發者需要頻繁編寫或更新項目文檔、描述代碼變更以及進行代碼審查的需求,通過標準化的 Skill 接口提供自動化支持。

核心能力

docgen 提供四個自包含的技能,均基於 SKILL.md 規範:

  • README 生成:從代碼庫生成或重寫 README.md,僅輸出基於證據的內容。
  • PR 描述生成:基於代碼差異和提交歷史生成完整的 PR 描述。
  • 變更日誌生成:對 Git 歷史進行分類、合併和重寫,生成 CHANGELOG。
  • 代碼審查:輸出結構化的審查意見,包含判定結果、分級問題列表和亮點。

安裝與啓用

通過 DSH 的插件加載器安裝:

dsh plugin --profile demo add github:JohnXu22786/docgen

使用方法

在會話中自然語言觸發技能,系統會根據 description 或 whenToUse 字段自動路由。典型示例包括:

  • “Write a README for this project”
  • “Generate a PR description for the change I just made”
  • “Update the changelog from git history and prepare 1.2.0”
  • “Help me review this PR”

技能輸出爲 Markdown 文本,可直接保存。調用時可附加風格參數,如 length=concise 或 language=en。

注意事項

  • 零依賴:插件無第三方依賴,支持離線運行。
  • 自包含:每個技能均爲自包含的 SKILL.md 文件。
  • 源碼安全:插件爲開源代碼,安裝前請檢查源碼。
  • 許可證:使用需遵守 MIT 許可證。

資源

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜