Agent Skills › uw-syfi/vibesys › plan-hypotheses

plan-hypotheses

GitHub

根据优化目标提出单一可证伪的性能改进假设,分析代码与测量数据,计算性能增益上限,并生成计划文件。不修改代码或运行基准测试,供负责人决策。

skills/search/plan-hypotheses/SKILL.md uw-syfi/vibesys

触发场景

vibesys optimize brief 要求提出假设 需要规划性能优化方案

安装

npx skills add uw-syfi/vibesys --skill plan-hypotheses -g -y
更多选项

非标准路径

npx skills add https://github.com/uw-syfi/vibesys/tree/main/skills/search/plan-hypotheses -g -y

不安装直接使用

npx skills use uw-syfi/vibesys@plan-hypotheses

指定 Agent (Claude Code)

npx skills add uw-syfi/vibesys --skill plan-hypotheses -a claude-code -g -y

安装 repo 全部 skill

npx skills add uw-syfi/vibesys --all -g -y

预览 repo 内 skill

npx skills add uw-syfi/vibesys --list

SKILL.md

Frontmatter
{
    "name": "plan-hypotheses",
    "description": "Use when a vibesys optimize brief asks you to propose one hypothesis as a plan file. Read-only on code: browses the optimization state and the code, picks its own idea, bounds the possible gain from measured peaks and observed numbers, and writes one falsifiable proposal into plans\/plan-NNN-<slug>.md. Changes no code and runs no benchmark."
}

Plan a hypothesis

You propose one idea; the lead decides. You edit no code, run no benchmark and submit no job. You write only your own plan file. Your brief gives the task name, a plan number NNN and maybe one short nudge. Nothing else: finding the idea is your job. State layout and plan files: vibesys:state.

Nudge

A nudge is a way of looking, never a target: find the bottlenecks (profile first, attack the largest measured cost); close the gap to the speed of light the most effective way; redesign from first principles; remove work (computation, copies, launches that need not happen); stack what exists (combine parked or won plans); mine prior art (the domain skill, published state of the art) and apply an idea directly or combine several that fit this task's specialization; reduce variance and tails. With no nudge, look however the evidence suggests.

Bold ideas

The nudge "bold" asks for a high-risk, high-reward idea: one that costs a lot to build, may replace how the work is done today, and pays off a lot if it works. Out-of-the-box is the point, so do not trim it to the next small step, and do not drop it for low confidence. Two things stay binding. The upside is still capped by the headroom you computed. And you plan it in stages: the first step is a cheap feasibility check with a stated kill criterion (the number below which you stop), so a miss costs one worker pass. Fill the Bold fields in proposal.md.

Work

  1. Read OBJECTIVE.md; its rules bind every idea. Read the plan index first (grep -H -m3 -E '^(status|claim|gain):' plans/*.md) and open full plan files only for plans near your idea. Then browse measurements/, scratch/ profiles and the code.
  2. Bound first. Compute the speed-of-light floor of the part you look at from the bytes and operations it must move and the hardware's measured peaks. The gap to the observed time is the headroom. Use the benchmark's observed operating point, not its configured one. An idea may not claim more than that headroom; if the part's time is unmeasured, say "unattributed" and make the first step a measurement.
  3. Claim early. As soon as you chose an idea, create plans/plan-NNN-<slug>.md with the header and a stub (slug and one-line claim). Before investing in details, list plans/ again: if a sibling already claimed the same mechanism, pick another idea and rename your file.
  4. Check premises cheaply: read the installed library or code to confirm the API, kernel or flag you rely on exists and fits this hardware. Check the idea against the rules in OBJECTIVE.md.
  5. Fill the ## Proposal section as in proposal.md: one claim that can succeed or fail alone, the arithmetic, the files touched, and the smallest first step that reaches a measurable commit in one worker pass. Leave ## Decision and ## Result empty.

Hand back

The plan file path, your confidence stated plainly, what you could not establish, and the measurement that would most change your view. Derive the idea from evidence and first principles; do not copy code from other systems.

版本历史

  • 3a50e8b 当前 2026-11-02 13:57

同 Skill 集合

.agents/skills/add-agent-provider/SKILL.md
.agents/skills/add-bundled-skill/SKILL.md
.agents/skills/build-client-feature/SKILL.md
.agents/skills/change-container-images/SKILL.md
.agents/skills/create-issue/SKILL.md
.agents/skills/enforce-rules/SKILL.md
.agents/skills/open-pr/SKILL.md
.agents/skills/review-pr/SKILL.md
.agents/skills/software-design/SKILL.md
.agents/skills/testing/SKILL.md
.agents/skills/vs-init/SKILL.md
.agents/skills/write-agent-prompt/SKILL.md
.agents/skills/write-docs/SKILL.md
.agents/skills/write-skills/SKILL.md
.agents/skills/write-vibesys-tests/SKILL.md
resources/chat-skills/reading-ideas/SKILL.md
resources/chat-skills/results-against-base/SKILL.md
resources/chat-skills/run-roles/SKILL.md
resources/chat-skills/steering-a-run/SKILL.md
resources/skills/dial9-tokio/skills/dial9-diagnose-long-poll/SKILL.md
resources/skills/dial9-tokio/skills/dial9-red-flags/SKILL.md
resources/skills/dial9-tokio/skills/dial9-runtime/SKILL.md
resources/skills/dial9-tokio/skills/dial9-toolkit/SKILL.md
resources/skills/dial9-tokio/skills/dial9-trace-analysis/SKILL.md
resources/skills/dial9-tokio/skills/dial9-trace-loading/SKILL.md
resources/skills/dial9-tokio/skills/dial9-trace-recipes/SKILL.md
resources/skills/dial9-tokio/skills/dial9-zoom-window/SKILL.md
resources/skills/kernel-correctness/SKILL.md
resources/skills/kernel-ncu-analysis/SKILL.md
resources/skills/kernel-performance/SKILL.md
resources/skills/kernel-rocprof-analysis/SKILL.md
resources/skills/microservice-optimization/SKILL.md
resources/skills/neuron-agentic-development/skills/neuron-nki-debugging/SKILL.md
resources/skills/neuron-agentic-development/skills/neuron-nki-docs/SKILL.md
resources/skills/neuron-agentic-development/skills/neuron-nki-profiling/SKILL.md
resources/skills/serving-systems/SKILL.md
skills/domains/dial9-tokio/dial9-rank-bottlenecks/SKILL.md
skills/domains/dial9-tokio/skills/dial9-diagnose-long-poll/SKILL.md
skills/domains/dial9-tokio/skills/dial9-red-flags/SKILL.md
skills/domains/dial9-tokio/skills/dial9-runtime/SKILL.md
skills/domains/dial9-tokio/skills/dial9-toolkit/SKILL.md
skills/domains/dial9-tokio/skills/dial9-trace-analysis/SKILL.md
skills/domains/dial9-tokio/skills/dial9-trace-loading/SKILL.md
skills/domains/dial9-tokio/skills/dial9-trace-recipes/SKILL.md
skills/domains/dial9-tokio/skills/dial9-zoom-window/SKILL.md
skills/domains/kernel-correctness/SKILL.md
skills/domains/kernel-ncu-analysis/SKILL.md
skills/domains/kernel-performance/SKILL.md
skills/domains/kernel-rocprof-analysis/SKILL.md
skills/domains/kernel-timeline-analysis/SKILL.md

元信息

文件数
0
版本
3a50e8b
Hash
11ae4538
收录时间
2026-11-02 13:57

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-11-03 18:43
浙ICP备14020137号-1