AgentSkillsCN

shaping-framing

在胶囊/卡片规划前,从混乱的记录和笔记中创建有证据支持的框架。适用于发现输入以对话为主且问题陈述仍较模糊时使用。

SKILL.md
--- frontmatter
name: shaping-framing
description: Create an evidence-backed frame from messy transcripts and notes before capsule/card planning. Use when discovery inputs are conversation-heavy and the problem statement is still diffuse.
argument-hint: "[topic and transcript paths, or context bundle to frame]"

Shape Framing (Adjunct)

Use this adjunct skill to distill conversation artifacts into a clear frame that can feed pragma planning.

Source And Adaptation Note

Adopted from rjs/shaping-skills (framing-doc) and adapted for this repository.

Modifications:

  • Namespaced as pragma:shaping-* to avoid routing ambiguity
  • Explicit pragma re-entry requirements
  • Authority boundaries aligned to docs/shape-pragma-integration.md

When To Use

  • Inputs are transcripts, call notes, or scattered stakeholder messages
  • The team agrees a problem exists but cannot state it crisply yet
  • You need an evidence-backed "why now" before capsule/card work

When Not To Use

  • You already have a stable capsule and clear next slice
  • The task is implementation-ready and only needs /pragma:card

Procedure

  1. Collect source inputs and confirm ordering when chronology matters.
  2. Extract direct evidence and separate it from synthesis.
  3. Produce a frame with Problem, Outcome, and boundaries.
  4. Identify what changed in understanding and what remains uncertain.
  5. Define the pragma re-entry step.

Required Output

md
## Frame
[evidence-backed problem and outcome]

## Handoff To Pragma
- Capsule impacts: [terms/invariants to add or revise]
- Candidate cards: [1-3 candidate slice behaviors]
- Open uncertainty: [items requiring `/pragma:spike`]
- Next command: [`/pragma:capsule` or `/pragma:card`]

Constraints

  • Do not prescribe implementation details.
  • Do not replace capsule authority over vocabulary and invariants.
  • Do not route directly to /pragma:slice.

Lifecycle

  • State: discovery
  • Next: /pragma:capsule (default) or /pragma:card (if capsule is stable)
  • Loop: /pragma:consult