Skip to content

Docs: 発表資料の表記を「スキル」へ揃える (#2065) - #2076

Merged
takemi-ohama merged 1 commit into
developfrom
docs/issue-2065-skill-wording
Oct 19, 2026
Merged

takemi-ohama merged 1 commit into
developfrom
docs/issue-2065-skill-wording

Conversation

@takemi-ohama

Copy link
Copy Markdown
Contributor

概要

発表資料「独自プラグイン開発の薦め」で英語の「Skill」とカタカナの「スキル」が混ざっていたのを、「スキル」へ揃えた(利用者の決定、2026-10-19)。5 ページ目「スキルとプラグイン」の公式の 2 語(スキル=作る単位、プラグイン=配る単位)に合わせている。

変更

  • script.md(台本の写し): 8 か所(構成の表 1・台本 5・7・20〔3 か所〕・21〔2 か所〕)
  • notes.md: 5 か所。尺の表を script-time.js の出力に合わせた(4,957 字・14 分 10 秒 → 4,943 字・14 分 07 秒)
  • slides/build-deck.js: 7 か所(5・7・26・27 ページ目の本文)
  • 台本の正本(Google ドキュメント): replaceAllText 8 件、すべて 1 件ずつ置き換え。書き出しを正規化して script.md と比べ差分 0
  • Google Slides: 同じ URL のまま差し替え。5・7・26・27 ページ目のサムネイルであふれ・重なりなし、書体は Noto Sans JP のまま

変えなかった箇所

  • 公式ドキュメントの題名: 「Claude Code: Skills」「Codex: Skills」「Agent Skills の紹介(Engineering Blog)」「Agent Skills(agentskills.io)」、notes.md の「Agent Skills の規格」
  • 5 ページ目の「スキル(Skill)= 作る単位」: 公式の英語の語との対訳として残した
  • ディレクトリ名 skill-plugin-development・URL・/ndf:… のコマンド名

テスト

  • uv run --frozen --project . --all-extras pytest tests/test_presentation_decks.py plugins/ndf/skills/release/tests -q → 38 passed
  • python3 scripts/check-skill-frontmatter.py → エラー 0

Refs #2065

🤖 Generated with Claude Code

https://claude.ai/code/session_01SyiLCs8wNrE2PKfeeqZDyT

散文の「Skill」を、5 ページ目「スキルとプラグイン」の公式の 2 語に合わせて
「スキル」へ揃えた(台本・構成メモ・生成スクリプト)。公式ドキュメントの題名
(Claude Code: Skills・Codex: Skills・Agent Skills)と「スキル(Skill)」の
対訳は変えていない。尺の表は script-time.js の出力に合わせた。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SyiLCs8wNrE2PKfeeqZDyT

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | codex | APPROVE

指定範囲の3ファイルに、指摘基準に該当する修正事項はありません。

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | kiro | APPROVE

発表資料1件の用語統一(『Skill』→『スキル』)と尺の表の更新のみ。3 ファイル(notes.md・script.md・slides/build-deck.js)を精査した。用語置換は 3 ファイル内で完結し整合している(英語のまま残るのは規格名『Agent Skills』のみで妥当)。尺の表は各ページ字数の合計が 4943、尺の合計が 847.4 秒、847.4 秒=14 分 07 秒、各ページ尺=字数/350×60 のいずれも一致し算術的に正しい。build-deck.js の変更は描画ヘルパへ渡す表示文字列のみでキーやロジックへの影響なし。critical/major の基準(利用者経路の破壊・秘密/認可/データ/不可逆操作・トークン/時間/回数の増加・設計の食い違い)に当たる指摘は無し。

@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | round 1 | commit (なし)

対応件数: critical=0 / major=0 / minor=0(合計 0 件)
決着: 0 件 / 見送り: 0 件 / 却下: 0 件
CI: PENDING

round 1 で落ちた pytest の 1 件(plugins/ndf/scripts/tests/test_external_ai_run.py::test_run_records_the_specified_model_when_not_observed[args0-default]、kiro の外部 AI 実行のテスト)は、発表資料の .md と build-deck.js の文言だけを変えるこの PR と無関係の一過性の失敗。手元では同テストが 2 passed。失敗ジョブは再実行済み(run 39179550785)。コードは変えていない

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | claude | APPROVE

指定範囲の 3 ファイル(notes.md・script.md・slides/build-deck.js)は発表資料の表記を『Skill』から『スキル』へ揃える変更と尺の表の更新だけで、指摘の基準(critical / major)に当たる修正事項はない。尺の表の字数の差(5・7・20・21 ページで計 -14 字、合計 4943 字・847.4 秒)は置換の回数と一致する。

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | kiro | APPROVE

発表資料1件の用語統一(『Skill』→『スキル』)と尺の表の数値更新のみ。3 ファイル(notes.md・script.md・slides/build-deck.js)を精査し、critical/major の基準に当たる指摘は無し。尺の表は 21 ページ・字数合計 4943・尺合計 847.4 秒で、847.4 秒=14 分 07 秒、各ページ尺=字数/350×60 のいずれも一致し算術的に正しい。用語置換は 3 ファイル内で完結し整合しており、英語のまま残るのは規格名・製品名(Agent Skills・Claude Code: Skills・Codex: Skills・『スキル(Skill)』の語釈)のみで妥当。build-deck.js の変更は表示文字列(リンクラベル・カード・コールアウト)だけで、オブジェクトのキー・URL・描画ロジックへの影響なし。

@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | commit (なし)

対応件数: critical=0 / major=0 / minor=0(合計 0 件)
決着: 0 件 / 見送り: 0 件 / 却下: 0 件
CI: NONE

@takemi-ohama
takemi-ohama merged commit b25ff0d into develop Oct 19, 2026
25 of 27 checks passed
@takemi-ohama
takemi-ohama deleted the docs/issue-2065-skill-wording branch October 19, 2026 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant