Agent skill

Xs Dev Workflow

by karaage0703 in karaage0703/ai-assistant-workspace

ソフトウェア開発タスクを進めるときの基本フロー。立ち上げ、ブランチ運用、実装、検証、PR作成、記録までを一気通貫で扱う。「実装して」「修正して」「PR作って」「コードを書く」「dev-workflow」で使用。

MITAuto-check passedDevelopment

Install Xs Dev Workflow

skills CLI
$ npx skills add karaage0703/ai-assistant-workspace --skill xs-dev-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install karaage0703/ai-assistant-workspace xs-dev-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/karaage0703/ai-assistant-workspace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xs-dev-workflow .claude/skills/xs-dev-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
xs-dev-workflow
GitHub stars
136
Token cost
~907 tokens
SKILL.md length
205 words
Files
2
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

ソフトウェア開発タスクを進めるときの基本フロー。立ち上げ、ブランチ運用、実装、検証、PR作成、記録までを一気通貫で扱う。「実装して」「修正して」「PR作って」「コードを書く」「dev-workflow」で使用。

  • Works in 8 steps: 作業種別を決める → リポジトリ状態を確認する → ブランチを切る → …
  • Development work in your project
  • SKILL.md covers 原則, Step 1: 作業種別を決める, Step 2: リポジトリ状態を確認する and Step 3: ブランチを切る, plus 7 more sections
  • Calls git, npm and gh

What it does

Xs Dev Workflow is an agent skill from karaage0703/ai-assistant-workspace. ソフトウェア開発タスクを進めるときの基本フロー。立ち上げ、ブランチ運用、実装、検証、PR作成、記録までを一気通貫で扱う。「実装して」「修正して」「PR作って」「コードを書く」「dev-workflow」で使用。

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Development. It works with Git and npm. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/xs-dev-workflow”

Requirements

  • Node.js

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. 作業種別を決める
  2. リポジトリ状態を確認する
  3. ブランチを切る
  4. 実装する
  5. 検証する
  6. コミットする
  7. PR を作る
  8. 記録する

What it can do on your machine

Read from SKILL.md and the folder at commit c689862. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • npm
    • gh
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, npm, gh and uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xs Dev Workflow loads about 907 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 205 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~907

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from karaage0703/ai-assistant-workspace at commit c689862, republished under its MIT licence (© karaage0703). 205 words, ~907 tokens.

Download SKILL.mdSave it as .claude/skills/xs-dev-workflow/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
xs-dev-workflow
description
ソフトウェア開発タスクを進めるときの基本フロー。立ち上げ、ブランチ運用、実装、検証、PR作成、記録までを一気通貫で扱う。「実装して」「修正して」「PR作って」「コードを書く」「dev-workflow」で使用。

dev-workflow

ソフトウェア開発タスクを、リポジトリ状態の確認から PR 作成・記録まで一貫して進めるためのスキル。

原則

  1. 先に状態を見る — git fetch、git status、既存 PR の有無を確認してから作業する
  2. 既存変更を壊さない — 自分が作っていない未コミット変更を勝手に戻さない
  3. 共有リポジトリは PR フロー — 公開・共有リポジトリでは小さな変更でもブランチを切る
  4. 検証を書く — PR 本文に何を確認したかを残す
  5. 節目を記録する — 長く続く作業は memory/YYYYMMDD.md や MEMORY.md に状態を残す
  6. 公開操作は確認する — push、PR作成、merge、release など公開リポジトリに影響する操作は、対象と操作内容を明示してユーザーのOKを取る

Step 1: 作業種別を決める

  • 既存リポジトリの修正: このスキルで続行
  • 小さな新規ツールやスクリプト: このスキルで続行
  • 要件が曖昧な大規模新規開発: 先に要件・設計・タスクへ分解する
  • 外部 API / SDK / フレームワークを使う実装: 実装前に最新ドキュメントを確認する

実装前に次の4点を短く固定する。

  1. ユーザーが解決したい問題
  2. 最初に触って確認できる最小のend-to-end経路
  3. 今回やらないこと
  4. ユーザーが成功と判断できる確認条件

将来向けの共通基盤や抽象化は、この最小経路に必要になるまで先行実装しない。

Step 2: リポジトリ状態を確認する

bash
git fetch origin
git status --short --branch
git branch --show-current

見るポイント:

  • いまいるブランチが作業対象と一致しているか
  • 未コミット変更があるか
  • その変更は自分のものか、既存のものか
  • 既に関連 PR が開いていないか

既存の未コミット変更がある場合、自分の作業と関係するものだけ慎重に扱う。無関係な変更は触らない。

Step 3: ブランチを切る

共有・公開リポジトリでは原則として専用ブランチを作る。

bash
git pull --ff-only
git switch -c fix/<short-topic>

既に関連 PR が開いている場合:

  • 小さく関連が強い変更: 既存 PR に乗せる
  • 独立した変更: 別ブランチ・別 PR にする
  • 判断に迷う場合: ユーザーに確認する

Step 4: 実装する

既存の構成・命名・テスト方針に合わせる。新しい抽象化や依存は、実際に複雑さを減らす場合だけ追加する。

「機能がない」「新しく実装する」と判断する前に、コード、設定例、README、docs、testsを検索する。コードと文書に機能がありruntimeだけ失敗する場合は、実装不足ではなく設定・反映・運用の問題として調査する。

編集後は差分を確認する。

bash
git diff

Step 5: 検証する

変更内容に応じて最小限でも検証する。

例:

  • ドキュメントのみ: git diff --check
  • Python: pytest、対象スクリプトの実行
  • Node.js: npm test、npm run lint、npm run build
  • UI: ローカル起動と画面確認

実行できなかった検証があれば、PR 本文と報告に理由を書く。

  • 初回利用・セットアップを変える場合は、既存の認証や事前データに依存しない隔離環境で、初期状態から目的を達成できることを確認する。本番設定を消して試さない。
  • ローカルでは変更箇所のテスト・短い静的検査・実機確認を行い、全体の回帰はCIへ任せる。CIがない場合や失敗再現が必要な場合はローカルで補う。同じ成功済み検査を理由なく繰り返さない。
  • 作業ディレクトリごとにlockfileに従って依存を導入する(例: npm ci / uv sync --frozen)。別checkoutの依存ディレクトリを共有して検証済みとしない。
  • lint・test・buildは対象リポジトリで定義されたコマンドを使う。

Step 6: コミットする

ステージングは対象ファイルを明示する。

bash
git add <file1> <file2>
git diff --cached
git commit -m "<summary>"

git add . や git add -A は、無関係な変更を巻き込みやすいので避ける。

Step 7: PR を作る

公開リポジトリで git push や gh pr create を行う前に、次のように対象操作を明示してユーザーのOKを取る。

text
これから public repo <owner>/<repo> に以下を実行します。
- branch <branch> を push
- PR を作成

OK?

OKが出たら実行する。

bash
git push -u origin <branch>
gh pr create --title "<タイトル>" --body "$(cat <<'EOF'
## 概要
- <変更点1>
- <変更点2>

## 検証
- [x] <実行した確認>
- [ ] <未確認の確認>
EOF
)"

PR 本文には以下を書く:

  • 何を変えたか
  • なぜ変えたか
  • どう検証したか
  • 未確認や残課題があるか

仕様、スコープ、検証結果が変わったら、その時点でPR本文も更新する。追加要件が入った場合、変更前にもらったレビュー・マージ承認を新しい差分へ流用しない。

マージ・配備・再起動

マージ、稼働環境への配備、サービス再起動はそれぞれ別操作として、ユーザーが許可した範囲だけ実行する。まとめて明示許可された場合は再確認しない。

  • マージ前: 対象PRの最新HEAD・検証結果・未解決指摘を確認する。
  • 配備前: 稼働checkoutと反映対象、設定・依存関係を確認する。
  • 再起動後: 実際のプロセス状態、反映された版、疎通を確認する。
  • 報告例: 「PRはマージ済み。配備・再起動は未実施」。コード統合だけで本番反映済みとは報告しない。

Step 8: 記録する

作業が長引く、別チャンネル・別セッションで引き継ぐ、PR を作った、方針転換した、完了した。こうした節目では記録する。

記録先:

  • memory/YYYYMMDD.md: その日の作業ログ
  • MEMORY.md: 継続中プロジェクトや長期的に残すべき情報
  • notes/: 調査結果や設計メモ

記録例:

markdown
### <repo>: <作業名>
- PR: <URL>
- 内容: <1〜3行>
- 検証: <実行したコマンドや確認>
- 次: <残っていること>

よくある事故とガード

  • 古い main からブランチを切る: git fetch origin を省略しない
  • 無関係な変更をコミットする: git add . を避け、git diff --cached を必ず見る
  • PR 本文が古いまま残る: 仕様変更や検証追加のたびに本文を更新する
  • 共有ファイルを上書きする: memory/、MEMORY.md、AGENTS.md のような共有ファイルは編集直前に再読する
  • 検証できていないのに完了扱いにする: 未検証なら未検証と書く
  • 既存機能を未実装扱いする: コード、設定例、docs、testsを検索してから判断する
  • 要件追加後も古い承認で進める: 差分と検証を更新し、必要な承認を取り直す

© karaage0703, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/xs-dev-workflow of karaage0703/ai-assistant-workspace.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit c689862

Compare with similar skills

Xs Dev Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xs Dev Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xs Dev Workflow this skillkaraage0703/ai-assistant-workspace136—~907Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT
Open Code Review CLIalibaba/open-code-review45k—~3.1kAutomated safety check: PassApache-2.0
Open Code Review Delegatealibaba/open-code-review45k—~2kAutomated safety check: PassApache-2.0
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Hunk Release Workflowmodem-dev/hunk9.6k—~3.8kAutomated safety check: PassMIT

Similar skills

  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    45k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Open Code Review Delegate

    alibaba/open-code-review

    Has the host agent do the code review itself while the ocr CLI handles file selection and rule lookup, covering workspace changes, branch ranges or single commits.

    45k GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Hunk Release Workflow

    modem-dev/hunk

    Maintainer workflow for preparing, publishing, verifying and curating Hunk releases, with confirmation gates before tags, publishes and public edits.

    9.6k GitHub stars~3.8k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Code Review

    yaklang/yakit

    对 Yakit 仓库的代码改动做规范化 code review:按代码逻辑、TS 定义、UI 引用与 Props、CSS 样式、依赖版本、配置项六个维度审查,检查测试用例缺失,强制执行 tsc 类型检查与 vitest 测试验证,输出「结果汇总 / 明细解释 / 合并结论」三块报告,经用户确认后写入文件。当用户要求 review、审查、评审代码改动,或在提交、合并、提 PR…

    7.8k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check: notes

More from karaage0703/ai-assistant-workspace

All 23 skills in this repo
  • Xs Arxiv

    karaage0703/ai-assistant-workspace

    arXiv論文の検索・トレンド発見・詳細分析を行う統合スキル。興味度スコアでユーザーに刺さる論文を自動選定。PDF全文読み込み・Notion蓄積対応。「arXivチェックして」「論文検索」「論文分析して」で使用。

    136 GitHub stars~1.4k tokensUpdated 16 days ago
    Auto-check passed
  • Xs Multi Agent

    karaage0703/ai-assistant-workspace

    異なるproviderのAI(Codex/Claude/Grok/Cursor/Antigravity等)から独立意見を集め、共通論点で相互検討して統合する。最初に利用可能エージェントを検出する。「みんなで考えて」「マルチエージェントで分析して」「複数のAIでレビューして」と言われたら使う。

    136 GitHub stars~1.8k tokensUpdated 16 days ago
    Auto-check passed
  • Xs Podcast

    karaage0703/ai-assistant-workspace

    ポッドキャストの音声取得・文字起こし・まとめを行う統合スキル。「ポッドキャストまとめて」「音声配信をダウンロード」「Podcastの内容を教えて」で使用。

    136 GitHub stars~557 tokensUpdated 16 days ago
    Auto-check passed
  • Xs Skill Creator

    karaage0703/ai-assistant-workspace

    スキルの作成・改善を行うスキル。既存スキルの分析から抽出したパターンとテンプレートで統一感のあるスキルを効率的に作成。スキルを作りたい、新しいスキルを追加したい、スキルを改善したい、SKILL.mdを書きたい場合に使用。

    136 GitHub stars~1k tokensUpdated 16 days ago
    Auto-check passed
  • Xs Bridge Ideas

    karaage0703/ai-assistant-workspace

    ワークスペース内の遠い知識や活動をつないで、新しいアイデアを生成する思考支援スキル。過去記事・メモ・発信資産から企画や実装ネタを出したい時に使用。「アイデア出して」「知識をつないで」「一見関係ないものをつないで」で使用。

    136 GitHub stars~487 tokensUpdated 16 days ago
    Auto-check passed
  • Xs Calendar

    karaage0703/ai-assistant-workspace

    カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。/calendar で発動。

    136 GitHub stars~441 tokensUpdated 16 days ago
    Auto-check passed

Works with

Categories

Questions about Xs Dev Workflow

What does Xs Dev Workflow do?

ソフトウェア開発タスクを進めるときの基本フロー。立ち上げ、ブランチ運用、実装、検証、PR作成、記録までを一気通貫で扱う。「実装して」「修正して」「PR作って」「コードを書く」「dev-workflow」で使用。. Xs Dev Workflow is an agent skill from karaage0703/ai-assistant-workspace.

When should I use Xs Dev Workflow?

Xs Dev Workflow fits situations like: development work in your project.

How do I install Xs Dev Workflow in Claude Code?

Run `npx skills add karaage0703/ai-assistant-workspace --skill xs-dev-workflow -a claude-code`. Or copy the skill folder (skills/xs-dev-workflow in karaage0703/ai-assistant-workspace) into .claude/skills/xs-dev-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Xs Dev Workflow in Codex?

Run `npx skills add karaage0703/ai-assistant-workspace --skill xs-dev-workflow -a codex`. Or copy the skill folder (skills/xs-dev-workflow in karaage0703/ai-assistant-workspace) into .agents/skills/xs-dev-workflow in your project. Codex loads it when a task matches its description.

Can I use Xs Dev Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add karaage0703/ai-assistant-workspace --skill xs-dev-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xs-dev-workflow, .gemini/skills/xs-dev-workflow, .github/skills/xs-dev-workflow and .opencode/skills/xs-dev-workflow in your project.

What does Xs Dev Workflow need to run?

Going by SKILL.md and its folder, Xs Dev Workflow needs the command-line tools its instructions call (git, npm, gh and uv). Our summary lists: Node.js.

Does Xs Dev Workflow access the network?

SKILL.md contains no URLs. Its commands use git, npm, gh and uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Xs Dev Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Xs Dev Workflow use?

Xs Dev Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xs Dev Workflow use?

About 907 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Xs Dev Workflow?

Skills that share tags, products or a category with Xs Dev Workflow: Migrate Internal Package into Ghost (TryGhost/Ghost, 56k stars), Open Code Review CLI (alibaba/open-code-review, 45k stars), Open Code Review Delegate (alibaba/open-code-review, 45k stars) and Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xs Dev Workflow?

karaage0703 (a GitHub user) maintains it in karaage0703/ai-assistant-workspace, which has 136 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on September 23, 2026.

Source: karaage0703/ai-assistant-workspace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.