spec-story-starter SKILL.md skillA

spec-story-starter from miyatti777/ai-plc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add miyatti777/ai-plc/spec-story-starter@git:20260708.e61f997

Pins git:20260708.e61f997 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
miyatti777/ai-plc
Path
core/skills/utility/spec-story-starter/SKILL.md
Versions recorded
1
Latest version
git:20260708.e61f997, committed Jul 8, 2026
Size
9,668 bytes
Repository stars
49
License
MIT

議論・議事録・選定された施策を起点に、対象リポジトリの実構造にgroundした「エンジニア向け Story(User Story + Acceptance Criteria)と Spec(技術仕様)」をSubagentで収束生成する。target_repoで対象コードベースを、backlog_db_urlで起票先バックログを選べる汎用スキル。抽象的な打ち手を実装可能な仕様へ絞り込む収束フェーズの実行に使う。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# spec-story-starter — Feature Story & Spec Starter(汎用・Subagent収束型)

議論/議事録/選定済み施策を起点に、**対象リポジトリの実構造にgroundした Story + Spec** を生成し、指定バックログに起票(またはローカル出力)する。特定ツール連携の専用版スキル(v1.1)を、任意リポジトリ・任意バックログに向けられる汎用スキルへ翻案したもの。

**収束の中核:** 抽象的な施策(「補充リマインドをやる」)を、複数Subagentで「既存コードのどこに何を実装するか」まで**絞り込む**。発散(広げる)の対に位置する収束(実装可能な1形に落とす)フェーズを担う。

## When to Use

- 発散・選定フェーズで決まった施策を、エンジニアに渡せる仕様に落としたいとき
- Chat/議事録の機能議論を、Story(受け入れ基準付き)とSpec(技術仕様)に一気に構造化したいとき
- 既存の簡素なStoryを、対象リポジトリの実装文脈で詳細化したいとき

## 入力インターフェース

| 入力 | 必須 | 説明 |
|------|------|------|
| `source` | ✅ | 起点。選定ドキュメント/議事録ページ/Chat議論/既存Story。パス・URL・直近会話のいずれか |
| `feature_label` | ✅ | 機能名(例: `補充リマインド配信`) |
| `target_repo` | ⭕ | **仕様をgroundする対象リポジトリのパス**。指定するとそのコード構造を読んで実装箇所を特定。未指定=カレントリポ or repo探索スキップ(構造非依存の一般Specになる) |
| `backlog_db_url` | ⭕ | **起票先バックログDB**(Notion DB URL / ローカルbacklogパス)。指定時はそこにStory行を起票。未指定=ローカル `<出力先>/Story.md` に出力 |
| `spec_output` | ⭕ | Spec出力先(ローカルファイルパス / Specs DB URL)。未指定=`<出力先>/Spec.md` |
| `detail_level` | ⭕ | `lean` / `standard`(既定) / `deep`。Story/Spec同一粒度 |

出力先が未指定の場合は `Flow/[YYYYMM]/[YYYY-MM-DD]/[feature_label]/` を既定とする。

## 処理フロー(Subagent収束)

```
source ──▶ P1 要旨抽出
                │
                ▼
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add miyatti777/ai-plc/spec-story-starter@sha256:a25c483da78bf644

The line at the top of this page pins the label git:20260708.e61f997, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_deq6h6vpdezcjne5.svg)](https://markdownregistry.com/a/art_deq6h6vpdezcjne5)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 8, 2026.

versioncommittedcommitsizeaudit
git:20260708.e61f997 latest2026-07-08 e61f997 9,668 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9668 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

miyatti777/ai-plc · 49 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_deq6h6vpdezcjne5
GET https://markdownregistry.com/api/v1/resolve?ref=miyatti777/ai-plc/spec-story-starter
GET https://markdownregistry.com/api/v1/blob/a25c483da78bf64431d929f982228f1adc5d83e0004e1d0b982a4058b59af54d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from miyatti777/ai-plc

01-collection SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/01-collection/SKILL.md · AI-PLC Stage 1 Collection。GoalとModeからExecution Contextを確立し、Context Store、intent.yaml、context.yaml、backlog.yamlを生成する。
git:20261001.354fe22 · audit A · 49 stars
02-inception SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/02-inception/SKILL.md · AI-PLC Stage 2 Inception。IntentとContextからGoalを分析し、BacklogとSub-Agent Registryを生成する。Goal分解、Re-Inception、backlog.yaml作成で使用す…
git:20261023.5118d6d · audit A · 49 stars
03-construction SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/03-construction/SKILL.md · AI-PLC Stage 3 Construction。Agent 定義が要るタスク(RUL_plc_adaptive §6: complex・platform_builder・慎重モード・委譲・長い実装)に対して実行可能なAgent定義と…
git:20261001.354fe22 · audit A · 49 stars
04-operation SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/04-operation/SKILL.md · AI-PLC Stage 4 Operation。Backlog(Agent定義があればそれ)に従ってタスクを実行し、成果物生成、検証、ステータス更新、Propagationを行う。
git:20261001.354fe22 · audit A · 49 stars
plc-auto SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-auto/SKILL.md · 固定Goalをnative Goalに設定し、この会話のAI-PLC Layerを自動完走する。利用者が $plc-auto の開始を明示した場合に使う。
git:20261001.3f9d966 · audit A · 49 stars
plc-backfill SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-backfill/SKILL.md · AI-PLCのスキルを通さずに済ませた作業を、あとから対象Layerに記録する(書き起こし・backlogへad-hocで追加・04-operation Phase 5.5〜7で検証後にcompleted)。書き込み前に承認を取る。
git:20260929.00950a4 · audit A · 49 stars
plc-brief SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-brief/SKILL.md · AI-PLC Projectの目的・成果・使い方・期待効果を根拠から平易に説明する。説明対象は読取専用。「このPJを説明して」「結局何ができた?」で使用。変更案の相談はplc-consult。
git:20261023.5118d6d · audit A · 49 stars
plc-consult SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-consult/SKILL.md · AI-PLC進行中のアイデア相談。今のLayerと照らして却下/タスク内で修正/Re-Inception/Re-Collection/いつかやるに振り分け、所感と次のコマンドを返す(読み取り専用)。「どう思う?」「次どのコマンド?」で使用す…
git:20261023.5118d6d · audit A · 49 stars
plc-db-sync SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-db-sync/SKILL.md · AI-PLCのローカルSQLite DBとNotion DBをpull、push、sync、statusで双方向同期する。DB同期、Notion反映、同期状態確認で使用する。
git:20261023.5118d6d · audit A · 49 stars
plc-decision SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-decision/SKILL.md · AI-PLCの承認・選択質問1件の背景、決定対象、変更範囲、負担、推奨、返信案を説明する読取専用入口。「何を承認すればいい?」「このAを選ぶと何が起きる?」「この承認を解説して」で使用。回答済み/旧版/不足/不要再確認候補を根拠で区別し、本…
git:20261023.5118d6d · audit A · 49 stars
plc-model-routing SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-model-routing/SKILL.md · AI-PLCのタスク内容に応じた担当モデルとAdvisor相談を、共通正本に従ってCodexで選択・実行する。モデル選択・相談の明示依頼またはmodel_routingを指定したLayer/Taskで使用する。
git:20261023.5118d6d · audit A · 49 stars
plc-next SKILL.md skill
miyatti777/ai-plc · codex/skills/ai-plc/plc-next/SKILL.md · AI-PLCの直前の結果と案件正本から、欠けた次の選択肢・おすすめ・開始文を補い、有効な既存Next Actionは再提示する。相談・再計画・次工程実行はしない。
git:20261023.5118d6d · audit A · 49 stars

Every file in miyatti777/ai-plc

Browse by kind, by grade A, or by owner.