docs: 日本語ライティング規範のスキルを導入 - #119
Merged
Merged
Conversation
k16shikano 氏の Gist (fd287c3) を .claude/skills/japanese-tech-writing として取り込み、日本語のレビュー・ドキュメント作成時の文章規範とする。 AGENTS.md の review 節から本スキルを参照するようにした。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013TCsENo93FrhfB8ohsSoXH
k16shikano 氏の Gist (eb2929f) を .claude/skills/cognitive-rhythm-writing として取り込む。japanese-tech-writing を前提に併用する規範であり、 兄弟ディレクトリ配置により `../japanese-tech-writing/SKILL.md` の参照が解決する。 AGENTS.md からも本スキルを参照する。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013TCsENo93FrhfB8ohsSoXH
Add guidelines for writing comments and documentation in Japanese.
limit7412
marked this pull request as ready for review
August 12, 2026 13:23
Revised guidelines for writing comments and documentation in Japanese, specifying the use of certain writing standards.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 72a4e61eae
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
This was referenced Aug 12, 2026
poropopo
pushed a commit
to poropopo/VRCARKitBlendShapeGenerator
that referenced
this pull request
Aug 14, 2026
k16shikano 氏の Gist を .claude/skills として取り込む。 - japanese-tech-writing (fd287c3): 日本語技術文書の文章規範 - cognitive-rhythm-writing (eb2929f): 認知リズムを生むためのライティング規範 （japanese-tech-writing を前提に併用する） AGENTS.md に document / comment セクションを追加し、 日本語の文章を書く際に両スキルを参照するよう明記する。 limit7412/github_notifications_slack#119 の移植。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01C4Aayvs2AYM6ajqyrxK86Q
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
k16shikano 氏の二つの Gist を、本リポジトリのプロジェクトスキルとして導入する。
このリポジトリはレビューを日本語で行う運用のため（
AGENTS.mdのreview節）、日本語の文章品質をそろえる規範を共有資産として取り込む。japanese-tech-writingcognitive-rhythm-writing変更内容
.claude/skills/japanese-tech-writing/SKILL.mdを新規追加。日本語の技術文書・書籍原稿の文章規範。.claude/skills/cognitive-rhythm-writing/SKILL.mdを新規追加。説明的な文章に緩急（認知リズム）を設計するための規範。AGENTS.mdのreview節から両スキルを参照し、日本語の文章を書く際に規範へ従うよう明示した。スキルの関係
cognitive-rhythm-writingはjapanese-tech-writingを前提とする併用スキルで、内部で../japanese-tech-writing/SKILL.mdを参照する。両者を
.claude/skills/直下の兄弟ディレクトリに置くことで、この相対参照が解決する。動作への影響
コード（Crystal / Lambda 本体）には変更がない。ドキュメントとエージェント向けの規範のみを追加する。
Claude Code は
SKILL.mdのdescriptionからスキルを自動検出するため、本リポジトリで日本語の文章を書く・レビューする作業に自動で適用される。