基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/archibate/dotfiles-opencode --skill defining-requirements命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Best practices for AI-driven English-to-Chinese translation. This skill should be used when the user asks to "translate to Chinese", "update the Chinese translation", "improve Chinese translation", "fix translation quality", "review Chinese translation", or when translating any English text into Chinese. Also applies when polishing an existing Chinese translation of English content.
This skill should be used when sending images, files, or notifications back to the user via messaging platforms (Discord, Feishu, Telegram, etc.) through cc-connect. TRIGGER when agent generates a plot/chart/screenshot and wants to show the user; agent creates a report/PDF/file the user should receive; agent needs to proactively notify the user (e.g. task completed, alert, reminder); user asks to "send image", "show me the chart", "notify me", "send the file", "send to Telegram", "show plot in Discord".
Browser automation CLI for AI agents. Use when needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. TRIGGER when user requests to "open a website", "fill out a form", "click a button", "take a screenshot", "debug this in browser", "scrape data from a page", "test this web app", "login to a site", "frontend UI/UX aesthetics", "automate browser actions", or any task requiring programmatic web interaction.
| name | defining-requirements |
| description | Skill to define requirements effciently as a product manager. |
Defining requirements is one of the most critical—and misunderstood—responsibilities of a product manager. The traditional "hand over a 50-page PRD and disappear" approach is broken. Modern product managers define requirements collaboratively, iteratively, and with a focus on outcomes, not just outputs.
Here is a practical guide to the good ways product managers can define requirements today.
Before picking a template, shift your mindset. Requirements are not a one-time artifact; they are a shared understanding that evolves.
Good: You refine requirements continuously through customer interviews, usability tests, and stakeholder feedback.
Bad: You write a spec, throw it over the wall, and move to the next thing.
Principle: The goal is not a perfect document—it’s a shared mental model.
User stories are the industry standard because they focus on who, what, and why.
Format:
As a [type of user] , I want [some goal] so that [some reason] .
Example:
As a frequent traveler, I want to save my payment details so that I can book flights faster.
Why it works:
But caution: User stories are placeholders for conversation, not contracts. Don’t just write them and walk away.
This is the Behavior‑Driven Development (BDD) technique we discussed earlier. It is not just for testers—it is the clearest way for a PM to define precise, testable requirements.
Format:
Scenario: Save payment details
Given I am a logged-in user
When I enter valid credit card information
And I check "Save this card for future use"
And I submit the payment
Then my card should be securely saved
And I should see it as an option on my next booking
Why PMs should write these:
Tooling: Cucumber, SpecFlow, Behave, or even simple checklists in Jira.
User stories alone can create a fragmented view. User Story Mapping (Jeff Patton) helps you visualize the entire user journey and prioritize ruthlessly.
How it works:
Why it’s good:
Tool: Miro, MURAL, or physical sticky notes.
If your product is used in varied contexts, Job Stories (from Intercom) are often more flexible than User Stories.
Format:
When [situation] , I want to [motivation] so I can [expected outcome] .
Example:
When I’m booking a last‑minute trip, I want to skip entering my payment details so I can complete the booking in under 30 seconds.
Why: It doesn’t assume a specific user role; it focuses on the context and causal mechanism.
Sometimes a picture is worth a thousand user stories.
Good: A clickable Figma prototype with annotated requirements attached to specific UI elements.
Even better: A prototype linked to the actual user story in your project management tool.
Why: Developers see exactly what to build, designers see the interaction, and QA can trace the requirement to the screen.
Common format:
In high‑uncertainty environments, defining requirements as hypotheses changes the conversation from “build this” to “test this”.
Format:
We believe that [building this feature] will achieve [this outcome] .
We will know we are successful when [measurable signal] .
Example:
We believe that allowing guests to checkout without an account will reduce cart abandonment.
We will know we are successful when guest checkout conversion is ≥ 65% and account sign‑ups drop by less than 10% .
Why it’s good:
Don’t write requirements in a silo. Before development starts, sit down with:
This is the Three Amigos meeting from BDD. It is the single highest‑leverage activity a PM can do to improve requirement quality.
Ambiguity kills requirements. Define the key terms your team uses—especially if you work in a complex domain (finance, healthcare, logistics).
Example:
Store these definitions in a wiki or directly in your specification tool. This prevents developers from making incorrect assumptions.
| Pitfall | Better Approach |
|---|---|
| Writing implementation details (“Use a dropdown”) | Describe the user need (“Select one of up to five options”) |
| Over‑specifying the UI | Use wireframes or low‑fidelity prototypes |
| Mixing business rules with UI text | Separate the logic from the copy |
| No negative scenarios | Always ask: “What if it fails?” |
| Requirements that can’t be tested | Write acceptance criteria that are verifiable |
Final thought: The best way to define requirements is not to define them once—it’s to create a shared understanding that evolves until the feature is in the user’s hands. Tools and templates help, but conversation and collaboration are what make requirements truly “good.”