Skip to content

docs: Markdown単語チェックskill設計を追加する#41

Open
ssaattww wants to merge 1 commit into
mainfrom
docs/markdown-word-checker-design
Open

docs: Markdown単語チェックskill設計を追加する#41
ssaattww wants to merge 1 commit into
mainfrom
docs/markdown-word-checker-design

Conversation

@ssaattww
Copy link
Copy Markdown
Owner

@ssaattww ssaattww commented May 20, 2026

Closes #40

概要

  • markdown-word-checker skill の設計を追加しました。
  • 各リポジトリ固有の用語・表記揺れルールは対象リポジトリの tools/lint/ から読み込む方針にしています。
  • review-enforcer と Markdown資料作成skillから呼び出す責務分担を整理しました。

設計内容

  • 作業者へ出すルールは Markdown lint の実行、指摘対応、不適切な指摘の設定見直し報告だけに限定。
  • skip / unsupported / failed gate による複数repo向けfallbackを定義。
  • sub-agentにlint証跡収集を委譲する場合のreport契約を定義。
  • backtick回避チェックと whitelist / prh のexact entry利用者レビュー境界を明記。

レビュー

  • 初回: reports/task-markdown-word-check-design-review-20260520230107.md
  • 修正: reports/task-markdown-word-check-design-fix-20260520230537.md
  • r2: reports/task-markdown-word-check-design-review-r2-20260520230107.md(no findings)

検証

  • git diff --check
  • sub-agent design review / r2 review

注意

  • 今回は設計追加のみです。skills/markdown-word-checker/SKILL.md の作成、既存skill変更、shared script移動は後続です。

## 背景
- Markdown資料作成者へ細かい用語規則を覚えさせず、repo固有lint設定を読む共通skill設計が必要になった

## 変更内容
- markdown-word-checker skillの目的、repo固有tools/lint設定の読み込み契約、review-enforcerとの呼び出し関係を設計した
- 複数repo対応の最低構成とskip/unsupported/failed gateの扱いを明記した
- sub-agent委譲時のreport契約、backtick回避チェック、利用者exact entryレビュー境界を設計に含めた
- 初回レビュー、修正、r2レビューのreportを追加した

## 検証
- git diff --check
- sub-agent design review: reports/task-markdown-word-check-design-review-20260520230107.md
- sub-agent design review r2: reports/task-markdown-word-check-design-review-r2-20260520230107.md
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.

Markdown単語チェックskillの設計を追加する

1 participant