Skip to content

AGENTS

Jump to bottom
nishi_74322014 edited this page Aug 3, 2026 · 9 revisions

プロジェクト ポリシー

主に以下の内容を、

当該リポジトリ（GitHub Wiki）に移行する作業を行う。

コンテンツに関しては、HTTPアクセスせず、ローカルのダンプを参照する。

._dump

コンテンツは其々以下のフォルダ以下に格納する。

  • .\techinfoofmicrosofttech
  • .\opentouryo
  • .\dotnetdevelopmentinfrastructure

コンテンツ作成

  • 基本的に *.md ファイルに移行する。ファイル名は英名で付与する。

  • ファイル名には、\ / : * ? " < > | を使用しない。また、先頭が _ だと特殊なファイルと認識されるので、しない。

  • トップページは、其々のルート・フォルダ以下の XX_FrontPage.md とする（XX_ は下記のプレフィックス）。

  • GitHub Wiki は同一名称のファイルを配置できないので（、重複時でなくても基本的に、）、以下のプレフィックスを付与。

    • MS_ .\techinfoofmicrosofttech
    • OTR_ .\opentouryo
    • DNET_ .\dotnetdevelopmentinfrastructure

  • 基本体裁は _Template.md に準拠し、作者の文脈（主張の核）を尊重しつつ、正誤チェック、補足、最新化などを行う。

  • トップページからリンク辿っていき、１フェーズ毎に、10ファイルづつに区切って移行する。

  • 添付ファイル

    • 図がある場合、*.md ファイルと同じフォルダに、同一ファイル名称 + _連番で出力する。
    • 図以外の添付ファイル（ZIP等）がある場合、
      • *.md ファイルと同じフォルダに、同一ファイル名称 + _元の添付ファイル名で出力する（連番は振らない）。
      • 同一ファイルが複数ページに添付されている場合は、1つだけ配置し他ページからは参照する。

  • エージェントはフォルダ階層は作成しない。階層化は必要に応じて人手で行う。

    • 階層化の提案をエージェントに求める、結果で git mv を依頼することはある。
    • 階層化後も（、ファイル名は一意でパスは使用されないので）、リンクを張り替える必要はない。

  • なお、作成済みのフォルダ階層に同列と考えられるコンテンツを配置することは許可される。

  • リンク先のページが以下に該当する場合、URLを移行先のファイル名に置換する。

  • リンク先のページがまだ存在しない場合、ファイル名を決めておき TODO.md ファイルに記録する。

  • リンクを作成する際は、.md(拡張子） を省略して記述する(GitHub Wikiの仕様）。

  • ファイル一覧は以下から取得し、

GitHubの操作

人の作業状態や未保存の作業を壊すので、以下の操作は行わない。

  • git checkout / switch / branch / reset / restore / stash

新規作成時を除き、更新操作においてMarkdownファイルの検収は人が行う。 エージェントは作業結果をワーキング ツリーに残すところまでを担当し、Git 操作は人が手動で行う。

従って、Markdownファイル更新操作において指示がない限り次を実行して検収前・未レビューの変更を確定・送信しない。

  • git commit / push

修正作業が完了したら何を変更したかを報告するに留める。コミットの要否とタイミングは人が判断する。

このWikiは「Open棟梁Project」,「OSSコンソーシアム 開発基盤部会」によって運営されています。

NetDevInfraWiki

マイクロソフト系技術情報 Wiki
Open 棟梁 Wiki

（未着手）

開発基盤部会 Wiki

移行管理: DONE ／ TODO

Clone this wiki locally