kf-g-writing-japanese-concise-structured-response

Japanese Writing Style For Markdown

The purpose of this skill is to apply consistent writing to Japanese Markdown documents and to align ordered lists and cross-references into a form that is easy to maintain.

When to use

• When writing a Markdown file
• When modifying a Markdown file
• When handling ordered lists in guides, procedures, runbooks, notes, etc.
• When item numbers are needed but you do not want to renumber every time an item is added midway or reordered
• When you want to reference an earlier item from a later item or from the body text in a form that is hard to break

Scope

• Markdown file body
• Headings
• Bullet lists
• Ordered lists
• Internal links
• Anchors

Out of scope

• User-facing response body (use the usual conversational tone)

Reference files

• references/markdown-style.md: Basic rules for Markdown body text, output policy, and notes for editing
• references/ordered-list-cross-reference.md: Operation of ordered lists and 1. anchor cross-references

How to read through

1. Check whether the target is Markdown body text
2. If handling Markdown body text, read references/markdown-style.md read
3. If there are ordered lists or internal references, also read references/ordered-list-cross-reference.md also read
4. Apply only the necessary perspectives and output

Common policy

• Do not use honorific language
• Use noun-ending style frequently
• Keep sentences short
• Prioritize bullet lists and numbered lists
• Reduce unnecessary conjunctions
• Avoid repeating abstract words
• Do not rewrite text beyond the requested scope entirely
• Do not change the meaning of existing information
• If the existing format has clear constraints, prioritize those constraints

Output policy

• When Markdown body text is requested, prioritize the completed form of the body text
• Unless an explanation is requested, do not add too much explanation outside the document
• Maintain the tone and style of the original document as much as possible
• Do not apply this skill's style to chat response body text

Final check

• If it is Markdown body text, have you checked references/markdown-style.md have you checked
• If there are ordered lists or internal references, have you checked references/ordered-list-cross-reference.md have you checked
• Have you not brought this skill's style into the chat response body?