菜单
Gest Spec. Draft or update a Gest spec artifact for substantial or unclear work, then ensure implementation happens through follow-on Gest tasks.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | gsp |
| description | Gest Spec. Draft or update a Gest spec artifact for substantial or unclear work, then ensure implementation happens through follow-on Gest tasks. |
Use when work needs product/design shaping before implementation.
Create a spec when behavior is unclear, there are meaningful trade-offs, acceptance criteria need negotiation, multiple systems are affected, or GitHub visible development is likely.
Before drafting or updating a spec, search Gest for related specs, tasks, iterations, prior decisions, and follow-ups:
gest search "<spec topic>" --all --json --limit 20
gest search "<affected feature/module>" --all --json --limit 20
Inspect relevant hits with gest task show, gest task note list, and
gest iteration show. Include durable references in the spec's References
section when they shape the proposal.
Also run the tag/dependency discovery from references/tag_dependency_workflow.md so
the spec captures existing semantic tags, proposed new tags, and code surfaces
that should be checked with ast-grep.
# Spec: <Title>
## Problem Statement
## Proposed Solution
## Scope
### In Scope
### Out of Scope
## Acceptance Criteria
## Open Questions
## References
Keep specs concise enough to read quickly.
Save as a Gest artifact tagged spec plus area tags:
gest artifact create "<title>" --tag spec --tag <area> --body "<body>" --quiet
Link to outline tasks where appropriate. Do not implement directly from the
artifact; use gpl/gis to create follow-on tasks.
Gest Setup. Bootstrap or refresh a jj/Gest agent-operable repository surface across tools, command contracts, Justfile targets, hooks, ignores, installs, and setup follow-ups.
Gest Test. Run unit, API regression, smoke, regression, and integration tests appropriate to the changed code; add missing tests when the task changes callable behavior.
Gest Brainstorm. Explore rough ideas or ambiguous requests, inspect existing code/docs/Gest context, ask clarifying questions when needed, and decide whether to create a spec, outline issue, plan, or session task.
Gest Commit. Create a jj commit/bookmark/push checkpoint using conventional commit style and GitHub metadata when present.
Gest Docs. Audit, create, update, and verify user-facing docs, developer-facing docs, and in-code documentation affected by a task.
Install jj Gest package extras after npx installs the skills, including hooks/settings and AGENTS guidance.