HN 日本語サマリー

← 一覧へ戻る
プログラミング

AIコーディングエージェントの編集を記録するローカル監査証跡ツール「Ponytrail」を開発しました

I built Ponytrail, a local audit trail for AI coding-agent edits (github.com)

16 pointsby 1997roylee8 コメント

要約

Ponytrailは、AIコーディングエージェントによるファイル変更の理由を記録し、その変更履歴をローカルの履歴ツリーとして表示するCLIツールです。以前のスナップショットからファイルを元に戻す機能も提供し、プロジェクト内の.pony-trail/フォルダに履歴を保持します。これにより、AIが生成したコードの変更を追跡し、必要なときに簡単に以前の状態に戻せるようになります。

全文翻訳

Packages

Omniskills

繁体中文

Power your ability.

OmniskillsはAIエージェント向けの多機能スキルバンクです。1つのワークフロー・スキルツリーをインストールし、目標を指定して1つのエントリー・スキルを呼び出すだけで、エージェントは目の前の問題に対して適切な役割、プレイブック、検証習慣を得られます。目的はシンプルです。専門スキルを個別に手動で管理する手間を省き、能力を3倍にすることです。

Startup Teamから始めると、承認されたスタートアップの目標を証拠に基づいた機能マイルストーンに分解し、実装前に各計画をレビューし、結果を検証し、受け入れ前にユーザーの期待、ニーズ、要望、ジャーニーをリプレイできます。各エビデンス・レジャーは、Verified(検証済み)、Inferred(推論)、Assumed(仮定)のクレームを区別します。高性能なホスト上では、選択されたスタートアップチームの役割が、境界が定められたステージ・パケットとして内部サブエージェントとして実行されます。フローは計画承認と機能受け入れで停止します。「Prepared, not executed」(準備済み、実行せず)は、内部起動またはインストールされたロールプロファイルが利用できない場合のフォールバックにすぎません。パブリックCLIディスパッチは無効のままです。

インストールされているベンチには、CEO、CTO、プロダクトマネージャー、Webデザイン、エンジニアリングマネージャー、ファウンディングエンジニア、Deliver Code、QAリードが含まれています。アクティブなマイルストーンは必要な役割のみを使用します。Deliver Codeは承認された境界を受け取り、ワークスペース書き込み権限を持つ唯一のメンバーです。実装後、スコープ内の1回の修正は、必要に応じてQAに新しいエビデンスを返すことができます。

内部実行はデフォルトのままです。計画承認後、ユーザーは別途明示的な計画後確認を通じて、実行スコープのvisible_taskのみを選択できます。これはgpt-5.6-terraモデル、推論作業量、プロジェクト、ファイルシステムターゲット、ワークスペース書き込み境界を指定します。計画承認や曖昧なapproveではタスクは作成されません。Git作業はデフォルトで分離されたワークツリーになり、ダーティ状態の依存関係はstartingState: working-treeを使用し、QAは結果と正確なワークスペースIDを待ちます。いかなる機能、正確なモデル、ターゲット/アクセス、作成失敗、調整、または結果収集の失敗も「Prepared, not executed」となり、パブリックCLIディスパッチは無効のままです。

Prepare -> Plan -> Plan approval -> Implement -> Rework if needed -> Verify -> User Outcome Replay -> Feature acceptance

Quick Start

フルセットのStartup Teamをインストールします。

npx omniskill@latest install startup-team

その後、エージェントに目標を指定して$startup-goalコーディネーターを実行させます。

$startup-goal I have an AI bookkeeping idea; help me choose the wedge and ship a v1 in two weeks

このエイリアスは、チェックインされたワークフローバンドルを指します。

npx omniskill@latest install 'https://github.com/devos-ing/omni-skills.git#examples/teams/startup-team'
Finance Team (ローカルプレビュー)

Finance Teamはまだomniskill@latestを通じて公開されていません。このリポジトリをクローンし、チェックアウトされたチームをインストールして$finance-researchを呼び出すことで、1つのソース化された公開企業のブリーフのために、会社、財務、評価、リスクのハンドオフを準備できます。

bun run dev -- install examples/teams/finance-team
Market Team (ローカルプレビュー)

Market Teamはまだomniskill@latestを通じて公開されていません。このリポジトリをクローンし、チェックアウトされたチームをインストールして$market-researchを呼び出すことで、1つのソース化されたレジームブリーフのために、マクロ、レート、市場構造、セクター、リスクのハンドオフを準備できます。

bun run dev -- install examples/teams/market-team

どちらのチームもホスト提供のブラウジングと公開ソースを使用します。市場データAPIは不要で、個人的な投資アドバイスは提供しません。自動ロール起動はこれらの2つのプレビューでは無効になっています。各Prepared, not executedハンドオフは、個別のユーザー制御タスクで実行し、完了した出力をコーディネーターに返します。

個別のスタートアップロールをインストールするには、専門的なワークフローが1つ必要な場合です。

npx omniskill@latest install ceo
npx omniskill@latest install cto
npx omniskill@latest install product-manager
npx omniskill@latest install web-design
npx omniskill@latest install engineering-manager
npx omniskill@latest install founding-engineer
npx omniskill@latest install qa-lead

スキルをインストールした後、エージェントを再起動して新しいエントリー・スキルをリロードしてください。

Installation truth

Startup Teamはチェックインされたスキーマ0.2ロックを保持しています。外部GitHubロケータは正確なコミットを使用し、宣言された各チームメンバーはルートチームと同じチェックアウトから解決されます。このロックは宣言された依存関係グラフとロケータをフィンガープリントしますが、ダウンロードされたリモートコンテンツを個別にスナップショットするわけではありません。

再インストール時、Omniskillsは既存のターゲットを、記録されたアーティファクトパスが所有権を確立する場合にのみリフレッシュします。管理されたプライマリとユーザー所有のミラーのような混合所有権を持つターゲットは、ユーザー所有のコピーを置き換える代わりにスキップされます。Finance TeamとMarket Teamは、完全なグラフが公開スモークテストに合格するまで、ロックなしのローカルプレビューのままです。

Workflow Registry

レジストリビューを使用してOmniskillsワークフローを選択し、そのロールワークフローを検査し、インストールコマンドをコピーできます。

[画像: Omniskills startup role workflow registry]

Startup Role Workflows

Omniskills workflowEntry skillWhat it helps with
Startup Team$startup-goalMove one evidence-backed feature milestone at a time through plan approval, implementation, conditional rework, verification, User Outcome Replay, and feature acceptance.
Finance Team (local preview)$finance-researchPrepare company, financial, valuation, and risk handoffs for a sourced public-company brief.
Market Team (local preview)$market-researchPrepare macro, rates, market-structure, sector, and risk handoffs for a sourced market-regime brief.
CEO$ceoDirection, hard tradeoffs, fundraising/customer framing, and company decisions.
CTO$ctoArchitecture, domain model, platform direction, and engineering risk.
Product Manager$product-managerProduct discovery, PRDs, acceptance criteria, roadmap tradeoffs, and issue slicing.
Web Design$web-designImplementable interface direction, responsive interaction states, and rigorous animation review.
Engineering Manager$engineering-managerDelivery sequencing, execution risk, quality gates, blocker triage, and engineering process.
Founding Engineer$founding-engineerRead-only implementation framing: affected seams, test strategy, technical risk, and execution handoff.
Deliver Code$deliver-codeDeliver approved vertical code slices through TDD, review, and fresh verification.
QA Lead$qa-leadRelease-risk review, acceptance checks, regression focus, reproduction gaps, and verification evidence.

各ワークフローは依然として検査可能なファイルです。workflow.json、オプションのworkflow.lock.json、README、およびローカルスキルが含まれます。パワーは、スキルツリーを一度インストールし、どのコンパニオンスキルを使用するかを知っているエントリー・スキルを呼び出すことから生まれます。

Which workflow should I use?
NeedChooseWhere it stops
Move one startup feature from direction through acceptancestartup-teamAfter QA, User Outcome Replay, and human feature acceptance; only the delegated deliver-code role writes.
Make one product decision or define customer-value scopeproduct-managerA read-only product recommendation, spec, ticket set, or delivery plan.
Turn a vague product request into approved delivery ticketsgrilled-product-devAn approved specification and vertical tickets; it does not implement the work.
Deliver a product or interface change with prototyping and reviewdevelopment-design-deliveryVerified implementation evidence after the approved design and plan.
Deliver a general engineering change with repository command disciplinereal-engineeringVerified engineering evidence after planning, TDD, and debugging.

Goal Loops

一部のOmniskillsワークフローは、目標が完了するまで継続されるべき目標のためのループランナーも公開しています。ループは再開可能なワークフロー状態です。loop startは実行を作成し、loop statusは現在の状態を示し、loop advanceは次に推奨されるアクションを返します。

ランタイムはアクションのみです。状態を記録し、次に推奨されるアクションを返しますが、ツールやシェルコマンドをエージェントのためにサイレントに実行することはありません。ループ実行状態はデフォルトで~/.omniskills/runs/<workflow-name>/<run-id>/の下に保存されます。

ループ可能なプロダクト開発ワークフローを試してください。

npx omniskill@latest loop start grilled-product-dev --json
npx omniskill@latest loop status grilled-product-dev --latest --json
npx omniskill@latest loop advance grilled-product-dev --run <run-id> --json

この形状は複雑な作業に役立ちます。目標を明確にし、1つのアクションを進め、エビデンスを検証し、目標が完了するまで進め続けます。

Built-In Workflow Ecosystem

Omniskillsワークフローは、ローカルスキル、バンドルされたスキル、および外部スキルパックを構成できます。

  • Matt Pocockのスキル:グリル、仕様、垂直チケット、プロトタイピング、TDD、診断、コードレビュー用。
  • Emil Kowalskiのスキル:デザインエンジニアリングとモーション用。正規の識別子はemilkowalski:emil-design-eng、emilkowalski:animation-vocabulary、emilkowalski:apple-design、emilkowalski:review-animationsです。これらは監査済みのコミットhttps://github.com/emilkowalski/skills/tree/6bf24434f7730ad169077756cf9c7cd7bd675fc6からインストールされます。古いinterface-craft:*識別子は互換性エイリアスのみです。
  • その他のワークフローパックも近日登場予定です。

omniskill installは、各ワークフロー・スキルのrepoメタデータを使用して、Skills CLI経由で不足している外部スキルを取得します。例えば、`{