技能 write-tech-spec

📦

write-tech-spec

Name: write-tech-spec
Author: warpdotdev

内容修订 r1 安全 ⚙️ 外部命令🌐 网络访问

Write Grounded Technical Specs

Technical plans often drift from product intent or the current codebase. This skill researches repository structure and turns constraints into an actionable TECH.md implementation plan.

支持: Claude Codex Code(CC)

🥉 77 青铜

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求

Review the Skillstore skill "write-tech-spec" from https://skillstore.io/skills/warpdotdev-write-tech-spec.md and its manifest at https://skillstore.io/api/skills/warpdotdev-write-tech-spec/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/warpdotdev-write-tech-spec.md 已签名 manifest GET /api/skills/warpdotdev-write-tech-spec/manifest 已签名 lockfile GET /api/skills/warpdotdev-write-tech-spec/lockfile

测试它

正在使用“write-tech-spec”。 A product specification for vertical tab hover behavior in an existing desktop application.

预期结果:

A TECH.md plan covering current workspace state, affected modules, proposed event handling, testing steps, and commit-pinned code references.

正在使用“write-tech-spec”。 A multi-module feature with uncertain implementation ownership.

预期结果:

A context section that identifies relevant files and data flow.
A proposed changes section that assigns ownership and explains tradeoffs.
A validation plan linked to the product behavior.

正在使用“write-tech-spec”。 A large feature with independent frontend and backend work.

预期结果:

A coordination plan that explains parallel worktrees, branch strategy, synchronization points, and sequential integration checks.

安全审计

安全

v1 • 2026/9/18 打开版本化报告

All 27 static detections are false positives caused by Markdown backticks, documentation URLs, or planning language in SKILL.md. The file describes how to write and validate technical specifications; it contains no executable command, network request, or prompt-injection instruction.

已扫描文件

分析行数

复核项

已忽略误报

风险因素

⚙️ 外部命令 (22)

🌐 网络访问 (2)

SKILL.md:40 SKILL.md:41

最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。

审计者: codex

分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告

复制报告链接

https://skillstore.io/skills/warpdotdev-write-tech-spec/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/warpdotdev-write-tech-spec/security.svg)](https://skillstore.io/skills/warpdotdev-write-tech-spec?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/warpdotdev-write-tech-spec?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/warpdotdev-write-tech-spec/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/warpdotdev-write-tech-spec.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

学术引用 (APA · BibTeX · CFF)

APA 引用

warpdotdev. (2026). write-tech-spec security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/warpdotdev-write-tech-spec/audits/1

BibTeX 引用

@techreport{warpdotdev-warpdotdev-write-tech-spec-2026,
  author = {warpdotdev},
  title = {write-tech-spec security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/warpdotdev-write-tech-spec/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "write-tech-spec security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "warpdotdev"
date-released: "2026-09-18"
url: "https://skillstore.io/skills/warpdotdev-write-tech-spec/audits/1"
identifiers:
  - type: other
    value: "skillstore:warpdotdev-write-tech-spec:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据证据置信度: 中

架构

可维护性

内容

社区

规范符合性

你能构建什么

Plan a multi-module feature

Translate an approved product concept into a scoped technical plan with affected modules, data flow, ownership, and tradeoffs.

Prepare work for implementation

Give an implementation agent a repository-grounded sequence of changes and concrete validation steps.

Align reviewers before coding

Document architecture decisions, risks, testing responsibilities, and optional parallel work before a large change begins.

试试这些提示

Start a basic specification

Read the relevant product specification and repository files. Draft a concise TECH.md with Context, Proposed changes, and Testing and validation.

Ground the plan in code

Inspect the current code for this feature, identify the main files, types, data flow, and ownership boundaries, then update the TECH.md plan with precise references.

Add validation coverage

Review this technical specification against the product behavior. Add concrete unit, integration, manual, or visual validation steps for every important behavior invariant.

Design coordinated execution

Evaluate whether parallel sub-agents reduce delivery time for this feature. If useful, define worktrees, branches, ownership boundaries, merge points, and validation ownership in the TECH.md.

最佳实践

Read the product specification and relevant code before proposing architecture.
Use commit-pinned references for important code locations.
Map every important product behavior to a concrete validation step.

避免

Do not guess about repository architecture when the code can be inspected.
Do not restate product behavior instead of linking the source specification.
Do not propose parallel agents without explicit ownership, worktree, and merge boundaries.

常见问题

What does this skill create?

It creates a repository-grounded TECH.md implementation specification for a significant Warp feature.

Does it implement the feature?

No. It documents the implementation plan, architecture, tradeoffs, and validation approach.

Does it require a PRODUCT.md file?

A PRODUCT.md file is preferred because it anchors user-visible behavior, but the skill can work from available requirements.

What repository information does it inspect?

It examines relevant files, types, data flow, ownership boundaries, and the current commit when references are needed.

When should I use the parallelization section?

Use it for large features where independent workstreams can reduce delivery time and have clear coordination boundaries.

Can it create Linear or GitHub issues?

Only after explicit user approval. Ticket creation is optional and should use the appropriate connected tool.

开发者详情

作者

warpdotdev

许可证

MIT

Skillstore 修订

版本提示

作者未声明版本。

仓库

https://github.com/warpdotdev/common-skills/tree/69b4753651ab7fab518c82be087b9f1d5b966631/.agents/skills/write-tech-spec

引用

0b0c8bd4f7023650f59eae864e7456d5a43fac55

维护新鲜度

2026/9/18

使用量

0 次下载 · 0 次浏览

文件结构

📄 SKILL.md

warpdotdev 的更多技能

查看全部

📦

council

Compare Decisions with an AI Council

Complex decisions can suffer from narrow analysis and hidden assumptions. This skill coordinates diverse agents, compares their evidence, and produces one actionable recommendation.

效率查看

📦

write-product-spec

Write Clear Product Specifications

Turn ambiguous feature requests into structured product specifications that align design, engineering, and review. This skill defines user-visible behavior, scope, references, open questions, and handoff details in a consistent PRODUCT.md format.

效率查看

📦

spec-driven-implementation

Plan Features With Living Specs

Substantial feature work can become ambiguous when product intent, technical decisions, and implementation drift apart. This skill guides agents through practical product and technical specifications that stay aligned with shipped work.

编码与开发查看

📦

migrate-to-factory

Migrate Workflows to Factory

Moving an existing agent workflow into Factory can create duplicate roles, broken paths, or conflicting handoffs. This skill guides a focused migration into an existing Factory repository and validates the resulting configuration.

DevOps 与基础设施查看

📦

respond-to-pr-comments-in-blocklist

Resolve Pull Request Feedback Safely

Pull request feedback can be difficult to track, implement, and answer consistently. This skill guides each decision, validates accepted changes, and previews GitHub responses before posting.

编码与开发查看

📦

diagnose-ci-failures

Diagnose CI Failures Faster

CI failures can hide the first useful error among checks, logs, and repeated noise. This skill gathers relevant GitHub evidence and produces a prioritized plan for repair.

DevOps 与基础设施查看

查看全部

📦