feat(writing-documents): extract the shared writing discipline - #20
Open
gitt510 wants to merge 2 commits into
Open
feat(writing-documents): extract the shared writing discipline#20gitt510 wants to merge 2 commits into
gitt510 wants to merge 2 commits into
Conversation
build-readme と build-pr-description が持っていた形式の規律を writing-documents に 1箇所化し、両者は委譲を宣言する。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…d and caller skills Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
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
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.
Why
build-readmeとbuild-pr-descriptionに二重に定義されており、document 型を足すたびに複製が増えるsynchronizeの2行とsize/*の2行、各ファイル4行)build-pr-descriptionが本文で「build-readme と同じく、匂い狩り(denylist)ではなく」と複製であることを自認していたWhat
writing-documents
build-readme / build-pr-description
writing-documentsへの委譲を宣言し、手順 step 1 で invoke するbuild-readmeが持つのは fact allowlist 4種・section composition・canonical section palette・README 固有の落ちる典型・fact の収集経路build-pr-descriptionが持つのは allowlist 5種・Why → What → Test → Notes 骨子・判断の住処・PR 固有の落ちる典型・fact の収集経路build-readmeは paragraph を h1 直下の lead のみに許し、nest と理由節を許さない。build-pr-descriptionは Why の nest と Notes の理由節だけを許すbuild-readmeにも効く(従来はbuild-pr-descriptionだけが持っていた)Test
writing-documentsを含む)と CLI 20 件bun run agent-skills listの inventory にwriting-documentsが description 付きで現れるNotes
skills/_shared/*.md)は却下 —src/cli.ts:233の destination がtarget.directory + skill.nameで skill directory 単位なので、symlink 経路では skill の外にある共有 file に到達できず plugin 経路だけで有効になるCLAUDE.mdの恒久 rule 化は却下 — 「paragraph 禁止」は成果物 document に限る scope が必要で、無条件の rule は会話の応答自体に効いてしまうwriting-documentsの description は単独 trigger を残した。誤発火のリスクはあるが、「この draft の地の文を落として」型の直接依頼が独立して発生するbuild-readme・build-pr-description)は成果物への assertion だけなので変更なしbun run lintは未実行 — devDependencies 未 install の環境で、TS に変更がないため CI に委ねる