specpilot-exec

A workflow for carrying out a confirmed software requirement in a project. It reads the requirement and project instructions, designs the implementation, records the plan, changes the code, and performs two reviews.

In plain words
What is it for?
Use it when executing a numbered SpecPilot requirement such as REQ-001, especially when the project uses requirement drafts and a project guide.
Why use it?
It gives a defined path from an approved request to working code. This helps keep changes focused and makes sure the requirement and review steps are not skipped.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/xtyooo/specpilot-codex/specpilot-exec
Any agent
npx skills add xtyooo/specpilot-codex --skill specpilot-exec
Clone the repo
git clone --depth 1 https://github.com/xtyooo/specpilot-codex

Made for: Claude Code, Codex.

Per session 46 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,358 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00046 $0.01358
Opus 5 $0.00023 $0.00679
Sonnet 5 $0.00009 $0.00272
Haiku 4.5 $0.00005 $0.00136

Measured 3d ago against content hash b1a9f641bba7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

specpilot-exec scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/specpilot-exec/SKILL.md · 171 lines

How it starts

The opening of the file, as written. The whole thing — 171 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SpecPilot: 执行需求

按照 SpecPilot 工作流执行需求。

参数

  • the user-provided arguments after the command text - 要执行的需求编号(如 REQ-001)

规则约束

  • 必须先读取项目指南:docs/specpilot/project-guide.md
  • 必须先读取需求草稿再开始
  • 如果需求已经过 /specpilot:confirm 确认,以【需求确认】部分为准进行设计和实施
  • 遵循草稿中指定的执行模式
  • 不修改与需求无关的代码
  • 保持实现最小化、聚焦
  • 技术方案确认后必须写入 draft 文件
  • 代码实施后必须进行两轮自动审查(重要!不可跳过!)

执行步骤

阶段一:准备

  1. the user-provided arguments after the command text 解析需求编号(去除空格)
  2. 如果未提供编号,运行 ls docs/specpilot/requirements/ 并询问用户要执行哪个需求
  3. 读取草稿文件:docs/specpilot/requirements/REQ-{编号}-draft.md
  4. 读取项目指南:docs/specpilot/project-guide.md
  5. 更新 docs/specpilot/requirements/index.md:将状态改为 🚧 in_progress

阶段二:上下文收集

  1. 如果指定了"关联需求",读取那些已存档的需求文件
  2. 如果指定了"代码位置说明",读取相关文件
  3. 如果未提供"上下文信息",自行分析相关代码理解上下文
  4. 检查是否存在 REQ-{编号}-tasks.md,如有则使用它作为任务清单

阶段三:技术方案设计

如果是"先出方案"模式(默认):

  1. 输出技术方案:
## 需求理解
[对需求的理解总结]

## 技术方案
### 改动范围
- 新增文件:xxx
- 修改文件:xxx

### 数据模型设计
[新增/修改的数据结构定义]

### 实现思路
[核心实现逻辑]

### 数据流/调用链路
[完整的数据流向说明,从输入到最终处理]

### 关键代码设计
[重要的代码设计,如核心方法签名、关键逻辑]

## 风险点分析
- [潜在风险1]
- [潜在风险2]

## 待确认
- [待确认点1]
- [待确认点2]
  1. 等待用户确认:"方案确认,请开始实施"

如果是"直接实施"模式:

  1. 仍然需要先设计技术方案(可简化),然后直接进入实施

阶段四:技术方案记录(重要)

用户确认方案后,必须将技术方案写入 draft 文件

  1. 在 draft 文件中添加或更新【技术方案】章节
  2. 如果方案有调整,更新版本号并记录变更原因

阶段五:实施开发

  1. 如果存在 REQ-{编号}-tasks.md,按任务顺序执行并标记完成
  2. 遵循 project-guide.md 中的项目规范
  3. 最小范围实现变更
  4. 添加必要的注释和日志

阶段六:代码自审(重要!不可跳过!)

代码实施完成后,必须进行两轮自动审查:

第一轮审查:完整性检查

  1. 需求覆盖检查

    • 对照需求确认中的每一项,检查是否都已实现
    • 检查所有字段是否都已正确处理
    • 检查边界条件是否都已覆盖
  2. 数据流检查

    • 追踪数据从输入到输出的完整路径
    • 检查 MQ/异步场景下数据是否能正确传递
    • 检查数据存储和读取的时序是否正确
  3. 代码一致性检查

    • 检查字段命名是否与需求/规范一致
    • 检查数据格式是否符合外部接口要求

第二轮审查:质量检查

  1. 代码质量

    • 是否有重复代码可以抽取公共方法
    • 错误处理是否完善
    • 日志是否充足
  2. 潜在问题

    • 是否有数据覆盖风险(更新嵌套字段时)
    • 是否有并发安全问题
    • 默认值处理是否正确
  3. 输出审查结果

## 代码自审结果

### 第一轮:完整性检查
- [x] 需求覆盖:所有功能点已实现
- [x] 数据流:数据传递路径正确
- [ ] 发现问题:[问题描述]

### 第二轮:质量检查
- [x] 代码质量:无重复代码
- [ ] 发现问题:[问题描述]

### 需要修复的问题
1. [问题1]:[修复方案]
2. [问题2]:[修复方案]

Read the full file on GitHub · 171 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 171 lines · 46 tokens per session scan A b1a9f641bba7

Subscribe to this mod's changes

specpilot-exec is a skill published in the GitHub repository xtyooo/specpilot-codex (10 stars, last pushed 6d ago), licensed MIT. It adds 46 tokens to every session and 1,358 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

obra/superpowers · 37 tokens

auto-perf-optimize

Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.

microsoft/vscode · 62 tokens

chat-perf

Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.

microsoft/vscode · 51 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens