Adonis0123/adonis-skills / skills/goal-gate
goal-gate
VerifiedGate whether a coding-agent task benefits from a durable, verifiable contract, then draft, validate, start, continue, or close it for Codex, Grok, Claude Code, Cursor CLI, or an unknown host. Use for explicit goal or /goal requests and autonomous multi-checkpoint coding work with one checkable end state. Native Goal creation or mutation requires an explicit user or system request. Do not use for quick one-shot work, unrelated backlogs, OKRs, reminders, or token-budget-only changes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.5 KB |
| agents/openai.yaml | config | 386 B |
| evals/evals.json | config | 46.5 KB |
| evals/trigger-eval.json | config | 3.7 KB |
| references/copy-ready-goals.md | markdown | 10.9 KB |
| references/examples.md | markdown | 26.7 KB |
| references/runtime-actions.md | markdown | 10.8 KB |
| scripts/lint-goal-prompt.pyexecutable | script | 6.2 KB |
| scripts/test-lint-goal-prompt.pyexecutable | script | 10.8 KB |
scripts/lint-goal-prompt.py
View on GitHub#!/usr/bin/env python3
"""Lint copy-ready goal prompts for required labels and unsafe vagueness."""
from __future__ import annotations
import re
import sys
from pathlib import Path
REQUIRED_GROUPS = [
("command", [r"/goal"]),
("verification", [r"Verification[::]", r"验证[::]"]),
("constraints", [r"Constraints[::]", r"约束[::]"]),
("boundaries", [r"Boundaries[::]", r"边界[::]"]),
("execution strategy", [r"Execution strategy[::]", r"执行编排[::]"]),
("iteration policy", [r"Iteration policy[::]", r"迭代策略[::]"]),
("stop when", [r"Stop when[::]", r"完成条件[::]", r"停止条件[::]"]),
("pause if", [r"Pause if[::]", r"暂停条件[::]", r"阻塞条件[::]"]),
]
REQUIRED_PATTERNS = dict(REQUIRED_GROUPS)
PLACEHOLDERS = [
# A complete inline link has a label, not a bracket placeholder.
# Keep scanning its destination and label for the other placeholder forms.
r"\[[^\]]+\](?!\([^\s()]+\))",
r"<[^>]+>",
r"\bTODO\b",
r"\bTBD\b",
r"待补充",
r"待定",
]
VAGUE_DANGERS = [
r"make sure it works",
r"edit anything",
r"change whatever",
r"keep trying",
r"until it (looks|seems|feels) good",
r"随便改",
r"随意修改",
r"一直尝试",
r"直到满意",
r"看起来不错就行",
r"感觉可以",
]
EVIDENCE_WORDS = [
r"\b(run|start|open|test|build|lint|typecheck|verify|inspect|capture|screenshot|log|artifact|file|url|api|browser|simulator|local)\b",
r"(运行|启动|打开|测试|构建|检查|验证|读取|截图|日志|产物|文件|链接|接口|API|浏览器|模拟器|本地|证据)",
]
DELEGATION_ASSESSMENT_WORDS = [
r"\b(assess|evaluate|decide|determine|judge|choose)\b",
r"(评估|判断|决定|选择)",
]
DELEGATION_OPTION_WORDS = [
r"\b(sub-?agent\w*|delegat\w*|single-agent|one agent)\b",
r"(子代理|子智能体|单 agent|主 agent)",
]
MAIN_AGENT_WORDS = [r"\bmain agent\b", r"主 agent", r"主代理", r"主智能体"]
OWNERSHIP_WORDS = [
r"\b(accountable|responsible|review|verify|verification|integrat)\w*\b",
r"(负责|责任|审查|复核|验证|集成)",
]
def marker_content(text: str, patterns: list[str]) -> str | None:
"""Read a labeled block without borrowing the next field's content."""
field_patterns = [
pattern
for name, group in REQUIRED_GROUPS
if name != "command"
for pattern in group
]
header = re.compile(rf"^[ \t]*(?:{'|'.join(patterns)})[ \t]*(.*)$", re.IGNORECASE)
boundary = re.compile(
rf"^[ \t]*(?:{'|'.join(field_patterns)}|/goal(?:[ \t]|$))",
re.IGNORECASE,
)
lines = text.splitlines()
for index, line in enumerate(lines):
match = header.match(line)
if match:
content = [match.group(1)]
for continuation in lines[index + 1:]:
if boundary.match(continuation):
break
# Markdown fences wrap content; they are not field values.
if not re.match(r"^[ \t]*(?:```|~~~)", continuation):
content.append(continuation)
return "\n".join(content).strip()
return None
def lint_text(text: str, label: str) -> list[str]:
errors: list[str] = []
if re.search(r"^\s*/目标\b", text, re.MULTILINE):
errors.append(f"{label}: use /goal, not /目标")
goal_match = re.search(r"^[ \t]*/goal(?:[ \t]+(.*)|[ \t]*$)", text, re.MULTILINE)
if goal_match is None:
errors.append(f"{label}: missing command")
for name, patterns in REQUIRED_GROUPS:
if name == "command":
continue
content = marker_content(text, patterns)
if content is None:
errors.append(f"{label}: missing {name}")
elif not content:
errors.append(f"{label}: empty {name}")
for pattern in PLACEHOLDERS:
if re.search(pattern, text, re.IGNORECASE):
errors.append(f"{label}: unresolved placeholder matched {pattern}")
for pattern in VAGUE_DANGERS:
if re.search(pattern, text, re.IGNORECASE):
errors.append(f"{label}: unsafe vague wording matched {pattern}")
verification = marker_content(text, REQUIRED_PATTERNS["verification"])
if verification and not any(re.search(pattern, verification, re.IGNORECASE) for pattern in EVIDENCE_WORDS):
errors.append(f"{label}: verification should name concrete evidence")
execution_strategy = marker_content(text, REQUIRED_PATTERNS["execution strategy"])
if execution_strategy:
assesses_delegation = any(
re.search(pattern, execution_strategy, re.IGNORECASE)
for pattern in DELEGATION_ASSESSMENT_WORDS
) and any(
re.search(pattern, execution_strategy, re.IGNORECASE)
for pattern in DELEGATION_OPTION_WORDS
)
if not assesses_delegation:
errors.append(f"{label}: execution strategy should assess delegation")
keeps_main_accountable = any(
re.search(pattern, execution_strategy, re.IGNORECASE)
for pattern in MAIN_AGENT_WORDS
) and any(
re.search(pattern, execution_strategy, re.IGNORECASE)
for pattern in OWNERSHIP_WORDS
)
if not keeps_main_accountable:
errors.append(f"{label}: execution strategy should keep the main agent accountable")
if goal_match is not None and len((goal_match.group(1) or "").strip()) < 20:
errors.append(f"{label}: /goal outcome is too short")
return errors
def main(argv: list[str]) -> int:
if len(argv) < 2:
print("Usage: lint-goal-prompt.py <file> [<file> ...]", file=sys.stderr)
return 2
errors: list[str] = []
for raw_path in argv[1:]:
path = Path(raw_path)
try:
text = path.read_text(encoding="utf-8")
except OSError as exc:
errors.append(f"{path}: cannot read file: {exc}")
continue
errors.extend(lint_text(text, str(path)))
if errors:
for error in errors:
print(error, file=sys.stderr)
return 1
print("Goal prompt lint passed.")
return 0
if __name__ == "__main__":
raise SystemExit(main(sys.argv))
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |