diataxis-writing

name	diataxis-writing
description	Diataxis documentation framework practice guide. Provides diagnosis, classification, templates, and quality assessment for four documentation types (Tutorial/How-to/Reference/Explanation).

Diátaxis Documentation Framework Practice

Quick Start

When creating or refactoring documentation:

Pre-Writing Questions (Must Ask)

Before starting, ask the user:

1. Language Preference: "What language should this document be written in?"

   • English / 中文 / Other

2. Output Method: "After completion, how would you like to output this document?"

   • Chat message (default)
   • Feishu document (via MCP/mcporter)
   • Local Markdown file
   • GitHub repository
   • Other platforms

Tool Availability Check (After User Selection)

After user selects output method, automatically check tool availability:

# Run auto-detection (script is in ./scripts/ relative to this skill)
python3 scripts/output-handler.py --detect

Check results:

• ✅ Tool available → Proceed with selected output method
• ⚠️ Tool not available → Inform user and suggest alternatives

For Feishu output via MCP:

• Check if mcporter is installed
• Check if MCP feishu server is configured (typically in /root/config/mcporter.json or ~/.mcporter/mcporter.json)
• Test connection to Feishu MCP server

If tool not available:

1. Inform user: "Selected output method [X] is not available"