AGENT SKILL

x-promote-ideation

Promote a transient x-ideate-feature output to a persistent ideation artifact in ai/ideations/.

License 许可
MIT
最近更新
2026-10-27
Stars
★ 0
Forks
1

01 前言 Front Matter

name
x-promote-ideation
model
haiku
description
Promote a transient x-ideate-feature output to a persistent ideation artifact in ai/ideations/.
allowed-tools
Read, Write, Bash
argument-hint
--ideation-id <ideation-NNNN> [--source stdin|<PATH>] [--dry-run]
context-budget
light
user-invocable
true
requires-capabilities
[]

03 SKILL.md 正文

Output Policy

  • Language: Portuguese (pt-BR) for content. English for technical terms and code identifiers.
  • Tone: Technical, Direct, and Concise.

Skill: x-promote-ideation

Purpose

Promote the transient output of x-ideate-feature into a persistent ideation artifact stored at ai/ideations/ideation-NNNN.md. Transient ideations exist only in the conversation context; this skill persists them so they can be consumed by x-create-product in a subsequent session.

When to Use

  • After x-ideate-feature produces a spec that the user wants to keep
  • Before x-create-product — the ideation must be persistent for the product creation step
  • When archiving a feature idea for later processing

CLI Command

ia-dev-env x-promote-ideation --ideation-id ideation-0001
ia-dev-env x-promote-ideation --ideation-id ideation-0002 --source ai/tmp/draft.md
ia-dev-env x-promote-ideation --ideation-id ideation-0001 --dry-run

Triggers

  • /x-promote-ideation --ideation-id <ideation-NNNN>
  • /x-promote-ideation --ideation-id <ideation-NNNN> --dry-run

Arguments

Flag Required Description
--ideation-id yes Ideation identifier — must match ideation-NNNN (e.g. ideation-0001)
--source no Source file path or stdin (default: stdin)
--dry-run no Validate without persisting

Output

Produces:

  • ai/ideations/ideation-NNNN.md — Persistent ideation artifact

Exit Codes

Code Meaning
0 Success
1 Validation error (invalid ideation-id pattern, source not found)
2 Execution error

Examples

# Promote from stdin (pipe from x-ideate-feature output)
ia-dev-env x-promote-ideation --ideation-id ideation-0001

# Promote from file
ia-dev-env x-promote-ideation --ideation-id ideation-0002 --source ai/tmp/feature-draft.md

# Validate only
ia-dev-env x-promote-ideation --ideation-id ideation-0001 --dry-run

Related Skills

Skill Relationship
x-ideate-feature Produces the transient ideation this skill promotes
x-create-product Consumes the persistent ideation produced by this skill

References

04 同仓库更多 Skills

review-bench
review-bench/edercnj_ia-dev-environment

x-parallel-eval

Detects and classifies file-collision risks between work units (tasks, stories, or epic phases) before parallel execution. Reads ## File Footprint blocks produced by x-task-plan / x-story-plan, applies the parallelism-heuristics knowledge pack (hard / regen / soft categories + hotspot overrides), and emits a collision matrix + serialization recommendation in Markdown (default) or JSON.

★ 0
review-bench
review-bench/edercnj_ia-dev-environment

parallelism-heuristics

Canonical catalog of file-collision heuristics for parallel task, story, and epic execution. Defines the File Footprint block format, the three Conflict Categories (hard / regen / soft), a hotspot list of high-contention paths, and the degrade-with-warning policy. Consumed by x-task-plan, x-story-plan, x-epic-map, x-parallel-eval, and x-dev-*-implement.

★ 0
review-bench
review-bench/edercnj_ia-dev-environment

x-watch-pr-ci

Polls a PR's CI checks and Copilot review status, blocking until checks complete or timeout. Returns one of 8 stable exit codes (SUCCESS=0, CI_PENDING_PROCEED=10, CI_FAILED=20, TIMEOUT=30, PR_ALREADY_MERGED=40, NO_CI_CONFIGURED=50, PR_CLOSED=60, PR_NOT_FOUND=70). Writes a versioned state-file for session resume.

★ 0
review-bench
review-bench/edercnj_ia-dev-environment

x-validate-docs

Documentation freshness gate: validates 6 dimensions (readme, api-specs, grpc-proto, adr, skill-docs, system-architecture) against code changes in a PR. Stack-aware — only validates targets declared/auto-detected from ProjectConfig.documentation.targets. Returns exit non-zero on staleness; produces structured report.

★ 0
review-bench
review-bench/edercnj_ia-dev-environment

x-update-system-architecture

Incrementally updates docs/architecture/system.md after an epic completes. Appends new entries to the Decision Log (§11) using x-internal-write-report --append (dedup by ## ID: marker) and surgically inserts component/integration changes into sections 1-10 via Edit. Idempotent: re-running with the same epic produces a byte-identical system.md.

★ 0
review-bench
review-bench/edercnj_ia-dev-environment

x-update-architecture

Incrementally updates the service architecture document with changes from architecture plans. Adds new components, integrations, flows, and ADR references without rewriting existing content. Use after implementation to keep architecture documentation current.

★ 0