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/openspec-context.md

View on GitHub
# OpenSpec 上下文

本 reference 只负责定位 change 和读取动态状态。topic-only 始终只读;change-draft 只有在用户显式
创建或同意持久化后,才能维护该 change 的 `brainstorm.md`,不得写其他 artifact 或实现代码。

## 状态快照

仅在用户明确指定 change、热上下文中已有唯一 change,或 `/opsx:*` 入口委托时启用。没有可复用
快照或快照已因写入、外部编辑、会话压缩而失效时,运行:

```bash
bash "<skill-dir>/scripts/openspec-status-snapshot.sh" "<name>"
```

使用返回的 `schemaName`、`changeRoot`、`artifactPaths`、`actionContext` 和 artifact 状态;不得猜测
固定路径。OpenSpec 1.12 状态优先读取 `isPlanningComplete`,只为旧 CLI 兼容读取 `isComplete`。

找到 brainstorm 的具体路径后运行:

```bash
node "<skill-dir>/scripts/planning-state.mjs" "<brainstorm-path>"
```

检查器只读并输出 `MISSING`、`LEGACY`、`DRAFT`、`CONFIRMED` 或 `INVALID`,以及 D/A/O 计数、
下游状态和 `applyReady`。OpenSpec 返回 `done` 只说明文件存在,不能替代这个语义状态。

恢复讨论时另读 brainstorm 的 `Planning 状态` 中可选的“讨论深度”和“选择来源”,按主 skill
的选择与恢复规则处理;`schemaName` 只提供默认值,不覆盖已有深度。检查器不把深度记录作为
确认或 Apply 门槛,旧文档缺少这些记录仍按原有 Living 状态继续。

恢复持久化讨论,或准备维护、确认、迁移时,先读 [Living brainstorm](living-brainstorm.md);
单纯状态查询无需加载它。读取引用不增加写入授权。

## 路径与写入边界

- 只读取 `artifactPaths.<id>.existingOutputPaths` 返回的文件;不得把待创建路径当作已存在。
- 用 `changeRoot` 解释相对链接,用 `actionContext` 判断规划与代码边界。
- change-draft 只能写动态 instruction 返回的 brainstorm `resolvedOutputPath`。
- `DRAFT`/`LEGACY`/`INVALID` 时不得生成下游 artifact;交回 Brainstorming 讨论或迁移流程。
- `CONFIRMED` 仍不自动表示 Apply ready;只有下游 `CURRENT` 且 OpenSpec `applyRequires` 完成时才可 Apply。

## topic-only

没有明确 change 时按 raw topic 调查。只有现有 change 可能冲突或可复用时才运行 `list --json`;
不能唯一选定时呈现候选差异,不擅自选择或创建。
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