docs-writer について
PRD、設計ドキュメント、ADR、監査レポート、機能アーカイブに対応する文書作成スキルです。文書があれば指定箇所を更新し、なければ作成に向けた要件整理を行います。
主な機能
- 01文書種別に応じた依頼の振り分け
- 02対応する執筆指示の読み込み
- 03既存文書の指定箇所の更新
- 04新規文書に向けた要件整理
- 05機能フォルダーのアーカイブ
活用シーン
- 01製品要件文書の作成
- 02技術設計書や ADR の執筆
- 03監査結果の集約
- 04完了した機能のコールドストレージへの移動
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ adeonir/ agent-skills --skill docs-writerインストール後、Claude Code で/docs-writerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlassets/adr.template.mddesign-doc.template.mdfeature-audit.template.mdfeature-design.template.mdfeature-prd.template.mdprd.template.mdproduct.template.mdinstructions/adr.mddesign.mdfeature-archive.mdfeature-audit.mdfeature-design.mdfeature-prd.mdprd.mdproduct.mdreferences/discovery.mdfeature-document.mdquality.mdreconcile.mdtracker-document.md詳細
Docs Writer
トリガー
| 種類 | 読み込むファイル |
|---|---|
| PRD — 製品要件 | prd.md |
| Feature PRD — 機能要件 | feature-prd.md |
| Feature Design Doc — 機能の技術設計 | feature-design.md |
| Audit report — 提供された監査結果を統合した調査結果 | feature-audit.md |
| PRODUCT — 戦略的なポジショニングとアイデンティティ | product.md |
| Design Doc — 簡潔な技術設計とトレードオフ | design.md |
| ADR — 単一のアーキテクチャ決定記録 | adr.md |
| Archive feature — 機能フォルダーをコールドストレージに移動 | feature-archive.md |
トリガーからドキュメントの種類を判別してください。不明確な場合は、ユーザーに確認してください。
両方のドキュメントを求める機能リクエストの場合は、まず feature-prd.md を読み込み、その後 feature-design.md を読み込んでください。
ワークフロー
trigger → detect type → load instruction → locate document → drafting
document exists → update the requested parts
document absent → full discovery
ADR → create a numbered record or update the requested record
archive → select feature folders → move to .artifacts/archive/features/
コメント
Markdown 対応