Community寫作與編輯github.com

Al0olo/Agents-village

以本倉庫的風格撰寫或編輯文件、README、PR 描述與研究散文。每當需要產出供讀者閱讀的散文時使用。

Agents-village 是什麼?

此技能用於確保所有讀者面向的散文皆遵循特定風格準則,包含文件、README、PR 描述與研究散文。它強調直接切入重點、簡潔句子、具體而非籠統的描述,並且避免敘述流程或自我指涉。技能也規範了表格與清單的使用時機,以及文件中不確定的表達方式。此外,它要求每個目錄都需有 `README.md`(說明目錄用途)與 `AGENTS.md`(給代理的規則),並限制讀者面向文件至多包含一個日期,操作狀態則應記錄在 `docs/HANDOFF.md` 與 `docs/handoff/LOG.md`。最後,它鼓勵以陌生人的角度重新閱讀,刪除任何會被跳過的內容。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Al0olo/Agents-village/tree/HEAD/.claude/skills/docs-style

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

文件風格

  • 直接切入重點。每一段一個想法。句子簡短。
  • 具體勝於籠統:一個數字、一個檔案、一個指令、一個名稱。
  • 讀者面向的文件中,不要有流程敘述或自我指涉。
  • 不要填充內容:刪除「值得注意的是」、「為了」、「穩健的」、「利用」、「全面的」、「無縫的」。
  • 表格僅用於比較;清單僅用於步驟或平行項目。
  • 不確定性只說一次,在適用的地方,並說明什麼情況能解決它。
  • 每個目錄都有一個 README.md(說明它是什麼,給人看的)和一個 AGENTS.md(代理可以據以行動的規則)。當目錄的用途或規則變更時,兩者都要更新。
  • 讀者面向的文件最多只帶一個作者署名和一個日期。操作狀態記錄在 docs/HANDOFF.md 和 docs/handoff/LOG.md。
  • 以陌生人的角度重新讀一遍。刪除任何他們會跳過的內容。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能