Skip to content
Skill

tanteki

by iwasa-kosui

AI Summary

読者が判断・実装・操作するために必要な情報を、できるだけ短く伝える。短くするために、事実、条件、根拠、例外、誰が責任を持つかを省かない。作業の進め方も、必要な確認ができる範囲で簡単にする。 ステップ0から順に検討し、依頼に対応できる最も簡単な進め方を選ぶ。ステップ1以上を選ぶ場合は、その理由を作業記録に残す。作業を細かく分けること自体を目的にしない。 指定箇所の修正、短い案内、一つの問いに答えれば済む文書は、ステップ0でよい。ステップ1以上では、執筆の分担と検査に従う。

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "tanteki" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/tanteki && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/tanteki/SKILL.md "https://raw.githubusercontent.com/iwasa-kosui/tanteki/main/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

日本語の業務・技術文書を、必要な情報を保ちながら短く分かりやすく書く。製品要求書(PRD)、設計書(Design Doc)、設計上の決定記録(ADR)、仕様書、手順書、調査・計画・報告書などの作成や推敲で使う。構成を確認してから本文を書き、内容と textlint の両方で検査する。通常の質問への回答には適用しない。

tanteki

読者が判断・実装・操作するために必要な情報を、できるだけ短く伝える。短くするために、事実、条件、根拠、例外、誰が責任を持つかを省かない。作業の進め方も、必要な確認ができる範囲で簡単にする。

作業の進め方を選ぶ

ステップ0から順に検討し、依頼に対応できる最も簡単な進め方を選ぶ。ステップ1以上を選ぶ場合は、その理由を作業記録に残す。作業を細かく分けること自体を目的にしない。 | ステップ | 進め方 | この方法では足りない場合 | |---|---|---| | 0 | 自分で構成を確認し、本文を書いて検査する | 各節で何を説明するか、構成案を作って検査する必要がある | | 1 | 構成案を検査し、別のエージェントに全文の執筆を一度で依頼する | 節ごとに資料を分けて読む必要がある、または執筆を分担する | | 2 | 構成案の作成と本文の執筆を別々に依頼し、節ごとに分担する | — | 指定箇所の修正、短い案内、一つの問いに答えれば済む文書は、ステップ0でよい。ステップ1以上では、執筆の分担と検査に従う。

書く前に決めること

どの進め方でも、本文を書く前に次を決める。決めた内容は、提出する本文の外に一行で添える。 • 文書の種類と読者。文書分類で区分とカテゴリを選び、該当する種類の参照資料を1ファイルだけ読む。その文書が果たす役割と、説明すべき内容を確認する。 • 主題。文書で伝えたいことや、読者ができるようになることを一文で表す。文書の構成に沿い、資料と読者に合わせて説明の順序や節の分け方を決める。 • 出典。各節の根拠となる原資料を示す。 • 用語。言い換えの指定があれば従う。指定がない用語は、最初に出てくる箇所で意味を説明する。 • 図の種類。図を使う節では、図の型を選ぶを参照する。

改稿でも変えないこと

ユーザーが指定した構成・見出し・書式を守る。他の節から参照されている見出し名や識別子も、階層を組み替えても変えない。 原資料の事実・数値・条件・否定・例外を保ち、未決定の事項を確定したように書かない。事実と提案を区別し、資料にない仕様を補わない。 指定箇所の修正では文書全体を組み替えない。既存の正式な参照先で足りる場合は、その参照と補足にとどめる。ただし、ユーザーが明示した作成依頼を省略しない。 名称を一括で置き換えるときは、引用、実際の列見出し、識別子に使われている文字列を対象から外す。原文や実際の名称と一致しなくなる変更を避ける。

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 1mo ago
● Active
AdoptionUnder 100 stars
50 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Stars50
Forks3
Issues2
Updated1mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code