Skip to content

MinLeeV5/devkeel / .harness/skills/brainstorming

brainstorming

Verified

探索、比较、挑战或补全开发方案;按 Lite/Full 深度组织相关问题、形成可读结论,并在用户同意持久化后维护 OpenSpec Living brainstorm。

FileKindSize
SKILL.mdskill md7.6 KB
agents/openai.yamlconfig220 B
references/living-brainstorm.mdmarkdown4.5 KB
references/openspec-context.mdmarkdown2.4 KB
scripts/openspec-status-snapshot.shexecutablescript1.1 KB
scripts/planning-state.mjsexecutablescript3.3 KB

references/living-brainstorm.md

View on GitHub
# Living brainstorm

进入或恢复持久化讨论、维护、确认或迁移时使用;仅查看 change 不授权写入。讨论控制遵循主 skill。
下文 `scripts/` 路径相对于 skill 根目录;已有路径与状态按 [OpenSpec 上下文](openspec-context.md)
获取,可靠快照可复用。

## 决定格式与状态

在 `brainstorm.md` 中保留决定编号、深度与来源,概要与分组只作阅读视图。
决定标题用纯 `#### D-03`,不插 HTML anchor;正文链接如 `[D-03](#d-03)`,跨 artifact
用 `[D-03](brainstorm.md#d-03)`。答案确认后可同轮写入 D/A,并移除已解决 O 或移入变更记录。
主题收口正文按需放在对应决定分组的阅读视图,引用 D/A 或仓库事实;不复制决定台账,不新增语义。

在 `Planning 状态` 的可选“讨论深度”“选择来源”中保存深度及来源(用户指定 / 工作流默认 /
上下文默认),不计入 D/A。按深度优先级恢复;迁入或切换 schema 不覆盖已有深度,用户确认切换后
来源记为用户指定。旧记录缺失时按默认规则选择,下次获准维护时补齐,不批量迁移。

语义变化重置为 `DRAFT`,下游设为 `STALE`(尚无下游则 `NONE`);纯排版、链接修复、深度切换
或记录补齐不改变确认及下游状态。不得仅因新默认深度重开已确认设计或阻止投影。

## topic-only → change-draft

用户按主 skill 的持久化条件同意建立 change 后:

1. 遵循 `openspec-new-change` 创建 Lite(显式/已确认 Full 除外),按动态 `resolvedOutputPath`
   初始化最小 `brainstorm.md`。
2. 原样迁入有效 D/A/O,保留深度、来源与可复用调查,状态为 `DRAFT`;不重问、不改写语义、不补最佳实践。
3. 运行 `scripts/planning-state.mjs` 检查结构,按 change-draft 缺口重评;有 gap 按主 skill 组织讨论,否则快照确认。

迁入回执只报数量、来源与下一 gap,不要求用户通读 Markdown。

## 快照确认

没有阻塞 O-*、不存在会改变结构、可观察行为或维护方式的开放决定,且目标、边界、行为、方案与
验证闭环、当前深度检查完成时:

1. 列出全部有效 D/A,每项一句话,说明下游 artifacts 与主要验证方式。
2. 只询问用户是否确认这份完整快照,不夹带设计问题;用户修正则保持 `DRAFT`、写回并继续讨论受影响项。
3. 用户明确确认后设置下列状态行;下游未生成时保持 `NONE`,交给 Continue/FF。

```text
> **状态:** `CONFIRMED` · **确认项:** 18 D / 3 A / 0 O
```

缺失、重复、计数不一致、存在 O-* 或状态行无效均不能视为 Confirmed。

## 分阶段确认(按需)

复杂需求有分阶段交接价值时,可先确认需求快照,再讨论和确认方案;简单任务沿用完整快照。
在现有 `Planning 状态` 按需记录各阶段已确认的 D/A 范围和实际用户确认来源,不另建语义台账。

- 需求阶段明确目标、范围、行为、验收及必要可行性,不等待完整技术方案;单阶段确认后整体仍为 `DRAFT`。
- 方案快照列出方案 D/A,并引用未变的已确认需求范围;两者合计必须覆盖全部当前有效 D/A。
  用户明确确认该完整快照且满足上节条件后,整体才改为 `CONFIRMED`;未变需求不再逐项重问。
- 仅方案变化时保留仍适用的需求确认;需求变化时使受影响的确认失效,并复核依赖它的方案。
  只讨论受影响决定,未变项保留编号和来源;整体重置与下游失效仍按前述规则处理。
- 旧文档缺少阶段记录时沿用原有完整快照,不要求补建或重新确认;记录补齐不改变原有确认状态。

检查器只校验整体 Living 结构;阶段范围、确认来源与语义依赖由 Agent 核对,阶段记录本身不授予投影或实施权限。

## 旧 change 的延迟迁移

- 旧百分比 DRAFT:检查器返回 `DRAFT` 与 `needsStageMigration: true`;下次维护按实际缺口改为
  `DRAFT` · `阶段` 格式,不得从旧分数直接映射阶段;保留 D/A/O、下游状态,不批量改写。
- 旧 `brainstorm.md` 没有 Living 状态行:首次 Continue/Update/Apply 从现有 artifacts 提取可追溯
  D/A/O 候选,保留下游文件,展示完整精简快照并等待确认或修正,不默认已确认。
  确认后改写为 Living 格式;下游忠实覆盖快照则 `CURRENT`,否则 `STALE`。
  仅新增、冲突或遗漏语义才重投影,不批量迁移。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall