Communitygithub.com

project-flow-ops

GitHub と Linear 間の実行フローを運用し、課題やプルリクエストをトリアージしてアクティブな作業をリンクし、GitHub を公開面として維持しながら Linear を内部実行レイヤーとして機能させます。バックログ管理、PR トリアージ、または GitHub から Linear への連携を行いたい場合に使用します。

project-flow-ops とは?

このスキルは、GitHub の Issue や PR と Linear のタスクを統合し、一貫した実行フローを提供します。主な目的は、コーディングではなく調整の問題を解決することです。GitHub を公開の真実の情報源とし、Linear を内部でアクティブな作業を追跡するための実行レイヤーとして位置づけ、すべての Issue を機械的に Linear に同期するのではなく、作業がアクティブ、委任済み、スケジュール済み、またはクロスファンクショナルである場合にのみ Linear を作成または更新します。このスキルは、Claude Code などの AI エージェントが PR バックログのトリアージ、Issue の分類(マージ、ポート/再構築、クローズ、保留)、Linear タスクの作成・更新、そして公開システムと内部システムの一貫性を維持するために使用できます。出力形式は、公開ステータス、分類、Linear でのアクション、そして次のオペレーターアクションを明確に示す構造化されたテキストです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/project-flow-ops

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Project Flow Ops

このスキルは、散在する GitHub Issue、PR、Linear タスクをひとつの実行フローに変換します。

問題がコーディングではなく調整である場合に使用してください。

使用タイミング

  • オープンな PR または Issue のバックログをトリアージする
  • 何を Linear に移し、何を GitHub のみに残すかを決定する
  • アクティブな GitHub 作業を内部の実行レーンにリンクする
  • PR をマージ、ポート/再構築、クローズ、保留に分類する
  • レビューコメント、CI の失敗、または古くなった Issue が実行をブロックしているかどうかを監査する

運用モデル

  • GitHub は公開およびコミュニティの真実の情報源です
  • Linear はアクティブなスケジュール作業のための内部実行の真実の情報源です
  • すべての GitHub Issue に Linear Issue が必要なわけではありません
  • 作業が以下の場合にのみ、Linear を作成または更新します:
    • アクティブ
    • 委任済み
    • スケジュール済み
    • クロスファンクショナル
    • 内部で追跡するほど重要なもの

コアワークフロー

1. まず公開面を読む

以下を収集します:

  • GitHub Issue または PR の状態
  • 作者とブランチの状態
  • レビューコメント
  • CI の状態
  • リンクされた Issue

2. 作業を分類する

すべての項目は、以下のいずれかの状態に分類する必要があります:

状態意味
マージ自己完結型、ポリシー準拠、準備完了
ポート/再構築有用なアイデアだが、ECC 内で手動で再実装すべき
クローズ方向性が間違っている、古い、安全でない、または重複
保留潜在的に有用だが、現在はスケジュールされていない

3. Linear が必要かどうかを判断する

以下の場合にのみ、Linear を作成または更新します:

  • 実行が積極的に計画されている
  • 複数のリポジトリまたはワークストリームが関与している
  • 作業に内部の所有権または順序付けが必要
  • その Issue が大規模なプログラムレーンの一部である

すべてを機械的にミラーリングしないでください。

4. 2つのシステムの一貫性を保つ

作業がアクティブな場合:

  • GitHub Issue/PR で公開状況を伝える
  • Linear で内部の所有者、優先度、実行レーンを追跡する

作業が完了または却下された場合:

  • 公開された解決策を GitHub に投稿する
  • 対応する Linear タスクを適切にマークする

レビュールール

  • タイトル、概要、または信頼だけでマージしないでください。完全な差分を使用してください。
  • 外部ソースの機能は、価値があるが自己完結型でない場合、ECC 内で再構築する必要があります。
  • CI が赤の場合、分類して修正するかブロックしてください。マージ準備完了と偽装しないでください。
  • 本当のブロッカーがプロダクトの方向性である場合、ツールのせいにせず、そう伝えてください。

出力形式

以下を返します:

公開ステータス
- Issue / PR の状態
- CI / レビューの状態

分類
- マージ / ポート再構築 / クローズ / 保留
- 1段落の根拠

Linear アクション
- 作成 / 更新 / Linear 項目は不要
- 該当する場合:プロジェクト / レーン

次のオペレーターアクション
- 正確な次のアクション

適切なユースケース

  • "オープンな PR バックログを監査し、マージすべきものと再構築すべきものを教えて"
  • "GitHub Issue を ECC 1.x および ECC 2.0 のプログラムレーンにマッピングして"
  • "これに Linear Issue が必要か、それとも GitHub のみで良いか確認して"

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

関連スキル