kotonoha 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.3.0] - 2026-09-30
11
+
12
+ ### Added
13
+
14
+ - Add the `consulting-analyst` skill for issue trees, testable hypotheses,
15
+ evidence discipline, Current–Target–Gap analysis, transparent option
16
+ comparison, Pyramid Principle synthesis, and traceable handoff to writing
17
+ and presentation skills.
18
+ - Add general-purpose Blueprint and White Paper doctypes with Japanese
19
+ templates, intake guidance, responsibility boundaries, traceability,
20
+ evidence controls, and review checklists.
21
+
22
+ ### Fixed
23
+
24
+ - Require ASCII half-width spaces immediately before and after Markdown
25
+ strong emphasis embedded in prose, and flag full-width, non-breaking, or
26
+ tab spacing such as `これは **「重要」** と説明する`.
27
+
10
28
  ## [0.2.0] - 2026-09-29
11
29
 
12
30
  ### Changed
package/README-ja.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # kotonoha
2
2
 
3
- kotonohaは、技術文書の作成とプレゼンテーション設計を支援するGitHub Copilot CLIスキルを提供します。`tech-writer`は、開発文書、要件・設計文書、運用・移行文書、調達文書、Qiita・Zenn記事の構成と文章を整えます。対応する文書の一覧は「対応している文書」に掲載しています。`presentation-planner`は、プレゼンテーションシナリオ、スライド構成、デザイン仕様、PPTX作成スキル向けの引き継ぎ情報を生成します。
3
+ kotonohaは、コンサルティング分析、技術文書、日本語表現、プレゼンテーション設計を支援するGitHub Copilot CLIスキルを提供します。曖昧な課題の構造化から、文書化、日本語表現の改善、プレゼンテーション設計までを一連の流れとして支援します。
4
+
5
+ `consulting-analyst`は、課題を論点、仮説、証拠、選択肢、提言へ構造化します。分析結果を受け取った`tech-writer`は、README、設計文書、Blueprint、White Paper、提案書などへ内容を落とし込みます。日本語の表現品質は`japanese-prose`がGiNZAベースの診断で改善します。プレゼンテーションが必要な場合は、`presentation-planner`がシナリオ、スライド構成、デザイン仕様、PPTX作成スキル向けの引き継ぎ情報を生成します。
4
6
 
5
7
  [English](./README.md) | [日本語](./README-ja.md)
6
8
 
@@ -8,9 +10,9 @@ kotonohaは、技術文書の作成とプレゼンテーション設計を支援
8
10
 
9
11
  `kotonoha`は、「言葉」「言語」「和歌」を表す古典的・詩的な表現「言の葉(ことのは)」に由来します。読み手の意図を、明確で構造化された言葉へ育てるという、このプロジェクトの目的を表しています。
10
12
 
11
- 『万葉集』との関係には補足が必要です。『万葉集』という書名を「万(よろづ)の言の葉、すなわち数多くの歌」と解釈する伝統的な説がありますが、書名の由来は確定していません。「やまとうたは、人の心を種として、よろづの言の葉とぞなれりける」という有名な表現の直接の典拠は、『万葉集』ではなく紀貫之による[『古今和歌集』仮名序](https://ja.wikisource.org/wiki/%E5%8F%A4%E4%BB%8A%E5%92%8C%E6%AD%8C%E9%9B%86%E4%BB%AE%E5%90%8D%E5%BA%8F)です。
13
+ 『万葉集』との関係には補足が必要です。その書名を「万(よろづ)の言の葉、すなわち数多くの歌」と解釈する伝統的な説がありますが、由来は確定していません。「やまとうたは、人の心を種として、よろづの言の葉とぞなれりける」という有名な表現の直接の典拠は、『万葉集』ではなく紀貫之による[『古今和歌集』仮名序](https://ja.wikisource.org/wiki/%E5%8F%A4%E4%BB%8A%E5%92%8C%E6%AD%8C%E9%9B%86%E4%BB%AE%E5%90%8D%E5%BA%8F)です。
12
14
 
13
- それ以前の『万葉集』にも、言葉が現実に働きかけるという近い思想が「言霊」として詠まれています。奈良県立万葉文化館の「万葉百科」では、山上憶良の[894番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=894)や[3254番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=3254)で確認できます。「言の葉」の歴史的な語義については、[コトバンク](https://kotobank.jp/word/%E8%A8%80%E3%81%AE%E8%91%89-503155)も参照しています。
15
+ 一方、それ以前に成立した『万葉集』でも、言葉が現実に働きかけるという近い思想が「言霊」として詠まれています。奈良県立万葉文化館の「万葉百科」では、山上憶良の[894番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=894)や[3254番歌](https://manyo-hyakka.pref.nara.jp/db/detailLink?cls=db_manyo&pkey=3254)で確認できます。「言の葉」の歴史的な語義については、[コトバンク](https://kotobank.jp/word/%E8%A8%80%E3%81%AE%E8%91%89-503155)も参照しています。
14
16
 
15
17
  ## tech-writerが解決する課題
16
18
 
@@ -20,7 +22,8 @@ kotonohaは文書構造と技術的な不変条件を固定してから日本語
20
22
 
21
23
  ## 主な機能
22
24
 
23
- - README、設計書・ADR、APIリファレンス、PR説明・コミットメッセージ・Issue、リリースノート、ユーザーマニュアル、コードコメント、要件定義書、システム設計書、テスト計画書、運用設計書・Runbook、移行計画書、セキュリティ設計書、技術提案書、RFI・RFP、Qiita・Zenn記事の作成とレビュー
25
+ - Issue Tree、仮説・証拠台帳、Current–Target–Gap、意思決定マトリクス、ピラミッド原則を使った事業・技術課題の構造化
26
+ - README、設計書・ADR、APIリファレンス、PR説明、コミットメッセージ、Issue本文、リリースノート、ユーザーマニュアル、コードコメント、要件定義書、システム設計書、テスト計画書、運用設計書・Runbook、移行計画書、セキュリティ設計書、技術提案書、Blueprint、White Paper、RFI・RFP、Qiita・Zenn記事の作成とレビュー
24
27
  - 文書種別ごとの推奨構成とチェックリスト
25
28
  - ID、事実、表、コード、受け入れ基準を変更せずに日本語表現を反復的に最適化する、GiNZAベースの独自`japanese-prose`文章診断
26
29
  - 文書作成後のrubber-duck reviewと、対応可能な指摘がなくなるまでの修正・再レビュー
@@ -46,21 +49,47 @@ kotonohaは文書構造と技術的な不変条件を固定してから日本語
46
49
  | 利用者向け文書 | ユーザーマニュアル、手順書、チュートリアル | `user-manual` |
47
50
  | ソースコード文書 | コードコメント、docstring | `code-comments` |
48
51
  | 社内向け技術提案 | アーキテクチャ、投資、デリバリー提案 | `technical-proposal` |
52
+ | 将来構想・変革設計図 | 事業、Operating Model、データ、技術のBlueprint | `blueprint` |
53
+ | 証拠に基づく解説・提言 | 技術・事業White Paper | `white-paper` |
49
54
  | 情報提供依頼 | RFI | `rfi` |
50
55
  | 提案依頼 | RFP | `rfp` |
51
56
  | 技術記事 | Zenn記事 | `zenn` |
52
57
  | 技術記事 | Qiita記事 | `qiita` |
53
58
 
54
- 再利用可能なテンプレートには、README、設計判断、ユーザーマニュアル、PR説明があります。要件定義、システム設計、テスト、運用、移行、セキュリティの各文書にも対応しています。技術提案、RFI、RFP、Qiita記事のテンプレートも含まれます。すべての文書種別には、`skills/tech-writer/references/doctypes/`配下に専用の構成ガイドとレビューチェックリストがあります。
59
+ 再利用可能なテンプレートには、README、設計判断、ユーザーマニュアル、PR説明があります。要件定義、システム設計、テスト、運用、移行、セキュリティの各文書にも対応しています。技術提案、Blueprint、White Paper、RFI、RFP、Qiita記事のテンプレートも含まれます。すべての文書種別には、`skills/tech-writer/references/doctypes/`配下に専用の構成ガイドとレビューチェックリストがあります。
60
+
61
+ ## consulting-analystの機能
62
+
63
+ - 文書やプレゼンテーションを作る前に、意思決定者、意思決定の問い、成果、範囲、証拠不足を定義
64
+ - フレームワークを機械的に埋めず、意思決定に必要な最小構成を選択
65
+ - Issue Treeと検証可能な仮説・証拠台帳を作成
66
+ - Current–Target–Gap分析と、採点基準・感度分析を伴う選択肢比較を実施
67
+ - 事実、推定、前提、解釈、提言を区別
68
+ - `tech-writer`と`presentation-planner`へ、証拠を追跡できる分析結果を引き継ぐ
69
+
70
+ 自然言語では、次のように依頼できます。
71
+
72
+ ```text
73
+ この事業課題をIssue Treeで構造化し、優先論点ごとに必要な証拠を整理して
74
+ ```
75
+
76
+ ```text
77
+ 現状と目標状態を比較してGapを特定し、Blueprint向けの分析を準備して
78
+ ```
79
+
80
+ ```text
81
+ 複数案を明示的な評価基準で比較し、不足する証拠を捏造せずに
82
+ White Paper向けの分析を作成して
83
+ ```
55
84
 
56
85
  ## presentation-plannerの機能
57
86
 
58
87
  - 対象者、意思決定、行動喚起、プレゼンテーションの制約を定義
59
88
  - ブリーフ、対象者の理解を導くシナリオ、主張型タイトルを使ったスライド構成を生成
60
- - YAMLデザイン仕様とPPTX作成スキル向けの決定的な引き継ぎ情報を生成
89
+ - YAMLデザイン仕様とPPTX作成スキル向けの再現可能で明確な引き継ぎ情報を生成
61
90
  - 経営判断、技術説明、データ報告向けのシナリオテンプレート
62
91
  - 経営提案、技術説明、データ報告向けのデザイン仕様
63
- - `.pptx`の生成、バイナリ編集、レンダリング、視覚的な品質確認は専用PPTXスキルへ委譲
92
+ - `.pptx`の生成、バイナリ編集、レンダリング、視覚的な品質確認は専用のPPTXスキルに委ねる
64
93
 
65
94
  ## セットアップ
66
95
 
@@ -72,7 +101,7 @@ kotonohaは文書構造と技術的な不変条件を固定してから日本語
72
101
 
73
102
  ### npmからインストール
74
103
 
75
- パッケージをインストールし、同梱CLIでスキルをスキルディレクトリへコピーします。
104
+ パッケージをインストールし、同梱CLIで各スキルを対象のスキルディレクトリへコピーします。
76
105
 
77
106
  ```bash
78
107
  npm install --save-dev kotonoha
@@ -81,16 +110,17 @@ npx kotonoha install
81
110
 
82
111
  ### 同梱スキルをまとめてインストール
83
112
 
84
- `kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。次のコマンドは、`tech-writer`、`japanese-prose`、`presentation-planner`を`.github/skills/`へインストールします。
113
+ `kotonoha install`は、まだ存在しない同梱スキルをすべてインストールします。次のコマンドは、`consulting-analyst`、`tech-writer`、`japanese-prose`、`presentation-planner`を`.github/skills/`へインストールします。
85
114
 
86
115
  ```bash
87
116
  npm install --save-dev kotonoha
88
117
  npx kotonoha install --skill all
89
118
  ```
90
119
 
91
- `--skill all`が既定値であるため、`npx kotonoha install`も同じ動作です。3つのスキルがインストールされたことを確認します。
120
+ `--skill all`が既定値であるため、`npx kotonoha install`も同じ動作です。4つのスキルがインストールされたことを確認します。
92
121
 
93
122
  ```bash
123
+ test -f .github/skills/consulting-analyst/SKILL.md
94
124
  test -f .github/skills/tech-writer/SKILL.md
95
125
  test -f .github/skills/japanese-prose/SKILL.md
96
126
  test -f .github/skills/presentation-planner/SKILL.md
@@ -106,25 +136,48 @@ npx kotonoha install --skill all --force
106
136
 
107
137
  kotonohaには独自開発の`japanese-prose`が同梱されるため、文章最適化スキルを別途インストールする必要はありません。`npx kotonoha install`により`tech-writer`と同じスキルルートへ配置され、GiNZAを使った文章lint、読解負荷検査、用語抽出、アウトライン検査、反復的な文章レビューをローカルで実行できます。この実装はkotonoha向けにゼロから開発しており、`natural-japanese`のソースコードを含みません。GiNZAの依存関係とライセンス情報は`skills/japanese-prose/NOTICE.md`に記録しています。
108
138
 
109
- 既定のインストール先は、現在のプロジェクトの`.github/skills/tech-writer`、`.github/skills/japanese-prose`、`.github/skills/presentation-planner`です。スキルを1つだけインストールする場合や、別の対応ディレクトリを使用する場合は、次のように指定します。
139
+ 自然言語で指示するときは、GiNZAを明示する必要はありません。「日本語文書を自然にする」「読みやすくする」「簡潔にする」「AIらしい定型表現を減らす」といった依頼をすると、同梱の文章最適化ワークフローが呼び出されます。
140
+
141
+ ```text
142
+ README-ja.mdの日本語を自然で読みやすい表現に修正して
143
+ ```
144
+
145
+ ```text
146
+ この設計書の不自然な日本語、長すぎる文、AIらしい反復表現を確認し、
147
+ 指摘を修正して
148
+ ```
149
+
150
+ 目的に応じて、次のようにモードを指定できます。
151
+
152
+ - ファイルを修正する: `README-ja.mdの日本語表現を最適化して`
153
+ - 修正せずにレビューする: `README-ja.mdの日本語をレビューして。ファイルは修正しないで`
154
+ - 採点だけ行う: `README-ja.mdの日本語表現を100点満点で採点して`
155
+ - すべての診断を実行する: `README-ja.mdをfullモードで日本語表現最適化して`
156
+ - GiNZAを明示する: `README-ja.mdをGiNZAで解析し、係り受けや読解負荷を改善して`
157
+
158
+ 新しい日本語文書では、`このリポジトリの日本語READMEを作成して`のように依頼すると、`tech-writer`が下書きと構造レビューを行い、rubber-duck reviewの前にGiNZAベースの文章最適化を実行します。文章最適化を確実に指定する場合は、`<ファイル名>を技術文書として作成または修正し、GiNZAによる日本語表現最適化まで実施して`と指示します。
159
+
160
+ 既定のインストール先は、現在のプロジェクトの`.github/skills/consulting-analyst`、`.github/skills/tech-writer`、`.github/skills/japanese-prose`、`.github/skills/presentation-planner`です。スキルを1つだけインストールする場合や、対応している別のディレクトリを使用する場合は、次のように指定します。
110
161
 
111
162
  ```bash
163
+ npx kotonoha install --skill consulting-analyst
112
164
  npx kotonoha install --skill presentation-planner
113
165
  npx kotonoha install --target .claude/skills
114
166
  npx kotonoha install --target ~/.copilot/skills
115
167
  ```
116
168
 
117
- `--skill <name>`を明示したインストールは、既存のスキルディレクトリを上書きしません。既存のインストールを確認またはバックアップし、選択したスキルを置き換える場合にだけ`--force`を指定します。
169
+ `--skill <name>`を明示したインストールは、既存のスキルディレクトリを上書きしません。すべてのスキルを置き換える場合は、既存のインストールを確認またはバックアップしてから`--force`を指定します。
118
170
 
119
171
  ```bash
120
172
  npx kotonoha install --force
121
173
  ```
122
174
 
123
- すべてのスキルをインストールする場合、既存のスキルディレクトリはスキップされ、不足しているスキルだけが追加されます。このため、`tech-writer`だけをインストール済みの環境から安全に更新できます。
175
+ 既定の全スキルインストールでは、既存のスキルディレクトリをスキップし、不足しているスキルだけを追加します。このため、`tech-writer`だけがインストールされた環境にも、ほかの同梱スキルを安全に追加できます。
124
176
 
125
177
  ```bash
126
178
  npx kotonoha install
127
179
  # Skipped tech-writer (...)
180
+ # Installed consulting-analyst (...)
128
181
  # Installed japanese-prose (...)
129
182
  # Installed presentation-planner (...)
130
183
  ```
@@ -139,7 +192,7 @@ npx kotonoha install
139
192
  npm install --save-dev kotonoha@latest
140
193
  ```
141
194
 
142
- 現在のプレリリース版を試す場合は、`next`タグをインストールします。
195
+ `next`タグで公開されているプレリリース版を試す場合は、次のようにインストールします。
143
196
 
144
197
  ```bash
145
198
  npm install --save-dev kotonoha@next
@@ -154,18 +207,19 @@ npx kotonoha install --force
154
207
  スキルを1つだけ更新する場合は、次のように実行します。
155
208
 
156
209
  ```bash
210
+ npx kotonoha install --skill consulting-analyst --force
157
211
  npx kotonoha install --skill tech-writer --force
158
212
  npx kotonoha install --skill japanese-prose --force
159
213
  npx kotonoha install --skill presentation-planner --force
160
214
  ```
161
215
 
162
- 最初のインストールで別のインストール先を指定した場合は、同じディレクトリを再度指定します。
216
+ 最初のインストールで別のインストール先を指定した場合は、更新時にも同じディレクトリを指定します。
163
217
 
164
218
  ```bash
165
219
  npx kotonoha install --target ~/.copilot/skills --force
166
220
  ```
167
221
 
168
- インストール済みパッケージのバージョンを確認し、置き換えられたファイルをコミット前に確認します。
222
+ インストール済みパッケージのバージョンと、置き換えられたファイルの差分をコミット前に確認します。
169
223
 
170
224
  ```bash
171
225
  npx kotonoha --version
@@ -178,9 +232,10 @@ git diff -- .github/skills
178
232
 
179
233
  このリポジトリでは、スキルが`.github/skills/`配下にリンクされているため、Copilot CLIで使用するための追加設定は不要です。
180
234
 
181
- 別のプロジェクトでソースチェックアウトのスキルを使用する場合は、スキルのディレクトリを対象リポジトリの`.github/skills/`、`.claude/skills/`、またはグローバルの`~/.copilot/skills/`へコピーします。
235
+ 別のプロジェクトでソースチェックアウトに含まれるスキルを使用する場合は、各スキルのディレクトリを対象リポジトリの`.github/skills/`、`.claude/skills/`、またはグローバルの`~/.copilot/skills/`へコピーします。
182
236
 
183
237
  ```bash
238
+ cp -r skills/consulting-analyst /path/to/your-repo/.github/skills/consulting-analyst
184
239
  cp -r skills/tech-writer /path/to/your-repo/.github/skills/tech-writer
185
240
  cp -r skills/japanese-prose /path/to/your-repo/.github/skills/japanese-prose
186
241
  cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
@@ -209,12 +264,16 @@ python3 skills/tech-writer/scripts/lint.py path/to/document.md
209
264
  ## リポジトリ構成
210
265
 
211
266
  ```text
267
+ skills/consulting-analyst/ # 課題構造化と証拠に基づく分析スキル
268
+ SKILL.md # 分析ワークフロー、制約、引き継ぎ
269
+ references/ # フレームワーク選択、証拠規律、引き継ぎ契約
270
+ assets/templates/ # ブリーフ、Issue Tree、証拠、意思決定、統合artifact
212
271
  skills/tech-writer/ # tech-writerスキル
213
272
  SKILL.md # スキル定義
214
273
  references/ # 構成原則、文書種別ごとの規則とチェックリスト
215
- references/doctypes/ # README、要件、設計、テスト、運用、移行、セキュリティ、API、PR・Issue、リリースノート、提案、RFI・RFP、Qiita・Zenn
274
+ references/doctypes/ # README、要件、設計、テスト、運用、移行、セキュリティ、API、PR・Issue、リリースノート、提案、Blueprint、White Paper、RFI・RFP、Qiita・Zenn
216
275
  scripts/lint.py # 構造とMarkdown表示のlintスクリプト
217
- assets/templates/ # 要件、設計、テスト、運用、移行、セキュリティ、調達などの文書テンプレート
276
+ assets/templates/ # 要件、設計、テスト、運用、移行、セキュリティ、将来構想、調査・提言、調達などの文書テンプレート
218
277
  skills/japanese-prose/ # 独自開発のGiNZAベース文章最適化スキル
219
278
  SKILL.md # 執筆、lint、レビュー、収束のワークフロー
220
279
  references/ # 執筆規則、レビューワークフロー、採点規則
@@ -226,12 +285,14 @@ skills/presentation-planner/ # シナリオ、デザイン仕様、PPTX引き継
226
285
  assets/scenario-templates/ # 経営判断、技術説明、データ報告向けシナリオ
227
286
  assets/design-templates/ # 経営提案、技術説明、データ報告向けYAMLデザイン
228
287
  .github/skills/tech-writer # Copilot CLIが読み込むskills/tech-writerへのシンボリックリンク
288
+ .github/skills/consulting-analyst
229
289
  .github/skills/japanese-prose
230
290
  .github/skills/presentation-planner
231
291
  ```
232
292
 
233
293
  ## 既知の制約
234
294
 
295
+ - `consulting-analyst`は、提供済みまたは検証済みの証拠を構造化します。市場データ、顧客情報、見積もり、引用を捏造しません。
235
296
  - `skills/tech-writer/scripts/lint.py`は、見出し、コードブロック、プレースホルダー、リンク、Markdown強調記号などの構造・表示上の問題を検出します。文章の自然さ、語彙、リズム、読解負荷は、別工程として呼び出される同梱`skills/japanese-prose`がGiNZAで検査します。
236
297
  - 文書種別は主に日本語の技術文書作成規則を前提としています。コミットメッセージの命令形などを含む多くのガイドは、英語文書にも適用できます。
237
298
  - `presentation-planner`だけでは`.pptx`バイナリを生成または検証できません。生成と視覚的な品質確認には専用PPTXスキルが必要です。
@@ -239,7 +300,7 @@ skills/presentation-planner/ # シナリオ、デザイン仕様、PPTX引き継
239
300
 
240
301
  ## 謝辞
241
302
 
242
- - [GiNZA](https://github.com/megagonlabs/ginza)(MIT License)— kotonoha独自の日本語文章診断に、形態素解析、品詞タグ付け、係り受け解析、見出し語化、文境界、固有表現抽出を提供します。
303
+ - [GiNZA](https://github.com/megagonlabs/ginza)(MIT License)— kotonoha独自の日本語文章診断に、形態素解析、品詞タグ付け、係り受け解析、原形化、文境界、固有表現抽出を提供します。
243
304
 
244
305
  ## ライセンス
245
306
 
package/README.md CHANGED
@@ -1,14 +1,13 @@
1
1
  # kotonoha
2
2
 
3
- kotonoha provides GitHub Copilot CLI skills for technical documents and
4
- presentation planning. `tech-writer` helps structure and polish README, design
5
- docs/ADRs, API reference, PR descriptions/commit messages/issue reports,
6
- release notes, user manuals/how-to guides, code comments, requirements
7
- definitions, system designs, test plans, operations runbooks, migration plans,
8
- security designs, technical proposals, RFI/RFP procurement documents, and
9
- Qiita/Zenn articles,
10
- structured so readers never get lost. `presentation-planner` turns source
11
- material into a reusable presentation scenario, slide outline, design
3
+ kotonoha provides GitHub Copilot CLI skills for consulting analysis, technical
4
+ documents, Japanese prose, and presentation planning. `consulting-analyst`
5
+ structures ambiguous problems into issue trees, hypotheses, evidence, option
6
+ comparisons, and recommendations. `tech-writer` turns that reasoning into
7
+ README, design documents, Blueprints, White Papers, proposals, and other
8
+ technical documents without losing the reader. `japanese-prose` improves
9
+ Japanese wording with GiNZA-based diagnostics. `presentation-planner` turns
10
+ source material into a reusable presentation scenario, slide outline, design
12
11
  specification, and handoff for a dedicated PPTX creation skill.
13
12
 
14
13
  [English](./README.md) | [日本語](./README-ja.md)
@@ -48,11 +47,15 @@ review.
48
47
 
49
48
  ## What it does
50
49
 
50
+ - Structure ambiguous business and technical problems with issue trees,
51
+ hypotheses, evidence ledgers, Current–Target–Gap analysis, transparent
52
+ decision matrices, and Pyramid Principle synthesis
51
53
  - Create/review README, design docs/ADRs, API reference, PR
52
54
  descriptions/commit messages/issue reports, release notes, user manuals,
53
55
  code comments, requirements definitions, system designs, test plans,
54
56
  operations runbooks, migration plans, security designs, technical proposals,
55
- RFI/RFP procurement documents, and Qiita/Zenn articles
57
+ Blueprints, White Papers, RFI/RFP procurement documents, and Qiita/Zenn
58
+ articles
56
59
  - Doctype-specific structure and checklists to guide writing
57
60
  - Original GiNZA-based `japanese-prose` lint, reading-load review, terminology
58
61
  checks, and iterative prose optimization without changing IDs, facts,
@@ -88,6 +91,8 @@ review.
88
91
  | User guidance | User manual, how-to guide, tutorial | `user-manual` |
89
92
  | Source documentation | Code comments, docstrings | `code-comments` |
90
93
  | Internal technical proposal | Architecture, investment, and delivery proposal | `technical-proposal` |
94
+ | Future-state blueprint | Business, operating-model, data, and technology transformation blueprint | `blueprint` |
95
+ | Evidence-led publication | Technical or business White Paper | `white-paper` |
91
96
  | Request for information | RFI | `rfi` |
92
97
  | Request for proposal | RFP | `rfp` |
93
98
  | Technical article | Zenn article | `zenn` |
@@ -96,10 +101,41 @@ review.
96
101
  Reusable templates are included for README, design decisions, user manuals,
97
102
  PR descriptions, requirements definitions, system designs, test plans,
98
103
  operations runbooks, migration plans, security designs, technical proposals,
99
- RFI, RFP, and Qiita articles. Every supported doctype includes dedicated
100
- structure guidance and a review checklist under
104
+ Blueprints, White Papers, RFI, RFP, and Qiita articles. Every supported
105
+ doctype includes dedicated structure guidance and a review checklist under
101
106
  `skills/tech-writer/references/doctypes/`.
102
107
 
108
+ ## What consulting-analyst does
109
+
110
+ - Defines the decision-maker, decision question, outcome, scope, and evidence
111
+ gaps before a document or presentation is written
112
+ - Selects the smallest useful framework set instead of filling frameworks
113
+ mechanically
114
+ - Builds an issue tree and testable hypothesis/evidence ledger
115
+ - Supports Current–Target–Gap analysis and weighted option comparison with
116
+ scoring anchors and sensitivity analysis
117
+ - Separates facts, estimates, assumptions, interpretations, and
118
+ recommendations
119
+ - Produces a traceable synthesis handoff for `tech-writer` and
120
+ `presentation-planner`
121
+
122
+ Example requests:
123
+
124
+ ```text
125
+ Structure this business problem as an issue tree and identify the evidence
126
+ needed to answer each priority issue.
127
+ ```
128
+
129
+ ```text
130
+ Analyze the current and target states, identify the gaps, and prepare the
131
+ analysis for a Blueprint.
132
+ ```
133
+
134
+ ```text
135
+ Compare these alternatives using explicit criteria and prepare a White Paper
136
+ handoff without inventing missing evidence.
137
+ ```
138
+
103
139
  ## What presentation-planner does
104
140
 
105
141
  - Defines the audience, decision, call to action, and presentation constraints
@@ -136,8 +172,8 @@ npx kotonoha install
136
172
  ### Install all bundled skills together
137
173
 
138
174
  `kotonoha install` installs every packaged skill that is not already present.
139
- The following commands install `tech-writer`, `japanese-prose`, and
140
- `presentation-planner` into `.github/skills/`:
175
+ The following commands install `consulting-analyst`, `tech-writer`,
176
+ `japanese-prose`, and `presentation-planner` into `.github/skills/`:
141
177
 
142
178
  ```bash
143
179
  npm install --save-dev kotonoha
@@ -145,9 +181,10 @@ npx kotonoha install --skill all
145
181
  ```
146
182
 
147
183
  `--skill all` is the default, so `npx kotonoha install` has the same behavior.
148
- Confirm that all three skills were installed:
184
+ Confirm that all four skills were installed:
149
185
 
150
186
  ```bash
187
+ test -f .github/skills/consulting-analyst/SKILL.md
151
188
  test -f .github/skills/tech-writer/SKILL.md
152
189
  test -f .github/skills/japanese-prose/SKILL.md
153
190
  test -f .github/skills/presentation-planner/SKILL.md
@@ -172,12 +209,40 @@ scratch for kotonoha and does not include `natural-japanese` source code.
172
209
  GiNZA dependency and license information is recorded in
173
210
  `skills/japanese-prose/NOTICE.md`.
174
211
 
175
- The default destinations are `.github/skills/tech-writer`,
176
- `.github/skills/japanese-prose`, and
212
+ You do not need to name GiNZA explicitly in a natural-language request.
213
+ Requests to make a Japanese document more natural, readable, concise, or less
214
+ formulaic invoke the bundled prose-optimization workflow. For example:
215
+
216
+ ```text
217
+ Rewrite README-ja.md in natural, readable Japanese.
218
+ ```
219
+
220
+ ```text
221
+ Review this design document for unnatural Japanese, overly long sentences,
222
+ and repetitive AI-like phrasing, then fix the findings.
223
+ ```
224
+
225
+ You can specify the intended mode more precisely:
226
+
227
+ - Edit the file: `Optimize the Japanese prose in README-ja.md.`
228
+ - Review without editing: `Review the Japanese in README-ja.md, but do not modify the file.`
229
+ - Score only: `Score the Japanese prose in README-ja.md out of 100.`
230
+ - Run every diagnostic: `Run the full Japanese prose optimization workflow on README-ja.md.`
231
+ - Request GiNZA explicitly: `Analyze README-ja.md with GiNZA and improve dependency depth and reading load.`
232
+
233
+ When creating a new Japanese document, asking `Create a Japanese README for
234
+ this repository` lets `tech-writer` create and structurally review the draft,
235
+ then run the GiNZA-based prose pass before rubber-duck review. To require the
236
+ pass unambiguously, ask: `Create or revise <file> as a technical document and
237
+ run GiNZA-based Japanese prose optimization.`
238
+
239
+ The default destinations are `.github/skills/consulting-analyst`,
240
+ `.github/skills/tech-writer`, `.github/skills/japanese-prose`, and
177
241
  `.github/skills/presentation-planner` in the current project. To install only
178
242
  one skill, or use another supported skill directory:
179
243
 
180
244
  ```bash
245
+ npx kotonoha install --skill consulting-analyst
181
246
  npx kotonoha install --skill presentation-planner
182
247
  npx kotonoha install --target .claude/skills
183
248
  npx kotonoha install --target ~/.copilot/skills
@@ -198,6 +263,7 @@ installation safe:
198
263
  ```bash
199
264
  npx kotonoha install
200
265
  # Skipped tech-writer (...)
266
+ # Installed consulting-analyst (...)
201
267
  # Installed japanese-prose (...)
202
268
  # Installed presentation-planner (...)
203
269
  ```
@@ -230,6 +296,7 @@ npx kotonoha install --force
230
296
  To update only one skill:
231
297
 
232
298
  ```bash
299
+ npx kotonoha install --skill consulting-analyst --force
233
300
  npx kotonoha install --skill tech-writer --force
234
301
  npx kotonoha install --skill japanese-prose --force
235
302
  npx kotonoha install --skill presentation-planner --force
@@ -263,6 +330,7 @@ into that repository's `.github/skills/`, `.claude/skills/`, or your global
263
330
  `~/.copilot/skills/`.
264
331
 
265
332
  ```bash
333
+ cp -r skills/consulting-analyst /path/to/your-repo/.github/skills/consulting-analyst
266
334
  cp -r skills/tech-writer /path/to/your-repo/.github/skills/tech-writer
267
335
  cp -r skills/japanese-prose /path/to/your-repo/.github/skills/japanese-prose
268
336
  cp -r skills/presentation-planner /path/to/your-repo/.github/skills/presentation-planner
@@ -292,12 +360,16 @@ works too (standard library only).
292
360
  ## Repository layout
293
361
 
294
362
  ```text
363
+ skills/consulting-analyst/ # problem structuring and evidence-led analysis skill
364
+ SKILL.md # analysis workflow, safeguards, and handoff
365
+ references/ # framework selection, evidence discipline, handoff contract
366
+ assets/templates/ # brief, issue tree, evidence, decision, and synthesis artifacts
295
367
  skills/tech-writer/ # the skill itself
296
368
  SKILL.md # skill definition
297
369
  references/ # structure constitution + doctype rules/checklists
298
- references/doctypes/ # README, requirements/design/test/operations/migration/security, API docs, PR/issue, release notes, proposals, RFI/RFP, Qiita/Zenn
370
+ references/doctypes/ # README, requirements/design/test/operations/migration/security, API docs, PR/issue, release notes, proposals, Blueprints, White Papers, RFI/RFP, Qiita/Zenn
299
371
  scripts/lint.py # structural lint script
300
- assets/templates/ # doctype skeletons including requirements, design, test, operations, migration, security, and procurement
372
+ assets/templates/ # doctype skeletons including requirements, design, test, operations, migration, security, strategy, evidence-led publications, and procurement
301
373
  skills/japanese-prose/ # original GiNZA-based prose optimization skill
302
374
  SKILL.md # writing, lint, review, and convergence workflow
303
375
  references/ # writing guidelines, review workflow, and scoring
@@ -309,12 +381,15 @@ skills/presentation-planner/ # storyline, design-spec, and PPTX handoff skill
309
381
  assets/scenario-templates/ # executive, technical, and data-report narrative scenarios
310
382
  assets/design-templates/ # executive, technical, and data-report YAML designs
311
383
  .github/skills/tech-writer # symlink to skills/tech-writer (where Copilot CLI reads it)
384
+ .github/skills/consulting-analyst
312
385
  .github/skills/japanese-prose
313
386
  .github/skills/presentation-planner
314
387
  ```
315
388
 
316
389
  ## Known limitations
317
390
 
391
+ - `consulting-analyst` structures supplied or verified evidence but does not
392
+ manufacture market data, customer facts, estimates, or citations.
318
393
  - `skills/tech-writer/scripts/lint.py` detects structural and Markdown
319
394
  rendering issues. Prose naturalness, vocabulary, rhythm, and reading load
320
395
  are handled by the separately invoked but bundled
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "kotonoha",
3
- "version": "0.2.0",
4
- "description": "GitHub Copilot CLI skills for technical writing and PPTX presentation planning.",
3
+ "version": "0.3.0",
4
+ "description": "GitHub Copilot CLI skills for consulting analysis, technical writing, Japanese prose, and PPTX planning.",
5
5
  "license": "MIT",
6
6
  "author": "nahisaho",
7
7
  "repository": {
@@ -27,6 +27,9 @@
27
27
  "github-copilot",
28
28
  "skill",
29
29
  "technical-writing",
30
+ "consulting",
31
+ "analysis",
32
+ "strategy",
30
33
  "documentation",
31
34
  "markdown",
32
35
  "presentation",