agentsclimarketplace

A 001 setup doc structure

Skill tkysi-mi/Yodogawa/skills/a-001-setup-doc-structure

docs/ 配下にプロジェクト/タスク用のディレクトリ構造と README を作成する。新規リポジトリでドキュメント基盤を初期化する際に使用。From its SKILL.md

Install
npx -y skills add tkysi-mi/Yodogawa --skill a-001-setup-doc-structure

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.2 KB, as published. Nobody here has run it

SetupDocStructure (a-001)

目的

  • プロジェクトルートに標準化されたドキュメントディレクトリ構造を作成する。
  • docs/README.md を作成し、ドキュメント構成と更新方針を明文化する。

前提

  • プロジェクトのルートディレクトリへの書き込み権限があること
  • docs/ ディレクトリが存在しない、または既存の構造を拡張したいこと

手順

1. ディレクトリ構造の作成

次のディレクトリを作成する(mkdir -p なので既存の場合は不足分のみ追加される)。

mkdir -p docs/project/01-requirements docs/project/02-behavior docs/project/03-domain docs/project/04-design docs/tasks

続いて docs/README.md を作成する。内容は reference/directory-structure.md の「docs/README.md テンプレート」をそのまま Write する。docs/README.md が既に存在する場合は、上書き前にユーザーへ確認する。

2. 結果の確認

ディレクトリ構造と docs/README.md が期待どおり生成されていることを確認。生成構造と各ディレクトリの用途は reference/directory-structure.md を参照。

3. Git への追加(オプション)

ユーザーに確認し、「はい」なら:

git add docs/
git status

推奨コミットメッセージは reference/directory-structure.md を参照。

4. 完了条件の確認

  • docs/ ディレクトリ構造が正しく作成されている
  • docs/README.md が作成されている

完了条件

  • プロジェクトルートに docs/ ディレクトリが作成されている
  • docs/project/ 配下に 01-requirements/, 02-behavior/, 03-domain/, 04-design/ が存在する
  • docs/tasks/ ディレクトリが存在する
  • docs/README.md が作成されている
  • ユーザーに作成結果が報告されている

エスカレーション

  • 既存の docs/ が存在し重要ファイルを含む: 「既存のドキュメント構造が検出されました。上書きや削除のリスクがあるため、手動で確認してください。」と警告し処理を中断
  • 権限エラー: 「ディレクトリの作成に失敗しました。書き込み権限を確認してください。」
  • Git リポジトリでない: 「このディレクトリは Git リポジトリではありません。必要なら git init を実行してください。」

参考

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.