Agent SkillsSisyphusSQ/harness-template › issue-goal-prompt

issue-goal-prompt

GitHub

根据Issue或文档生成可执行的目标提示词,提取范围、验收标准及步骤,支持状态持久化。

template/.agents/skills/issue-goal-prompt/SKILL.md SisyphusSQ/harness-template

Trigger Scenarios

需要整理任务上下文为清晰目标时 用户请求生成任务提示词或启动指令时

Install

npx skills add SisyphusSQ/harness-template --skill issue-goal-prompt -g -y
More Options

Non-standard path

npx skills add https://github.com/SisyphusSQ/harness-template/tree/main/template/.agents/skills/issue-goal-prompt -g -y

Use without installing

npx skills use SisyphusSQ/harness-template@issue-goal-prompt

指定 Agent (Claude Code)

npx skills add SisyphusSQ/harness-template --skill issue-goal-prompt -a claude-code -g -y

安装 repo 全部 skill

npx skills add SisyphusSQ/harness-template --all -g -y

预览 repo 内 skill

npx skills add SisyphusSQ/harness-template --list

SKILL.md

Frontmatter
{
    "name": "issue-goal-prompt",
    "description": "从 Linear、GitHub、GitLab、仓库文件或设计文档生成可执行目标提示词;适用于需要把任务上下文整理成清晰目标、范围、步骤和验证入口的场景。"
}

任务目标提示词

为任务生成具体目标提示词。除非用户明确要求继续实施,否则只生成提示词,不执行任务实现。

必要输入

  • issue_id、任务链接或仓库内任务文件路径;
  • 可选约束:执行模式、范围限制、来源文档、验证策略、分支 / 提交 / 推送边界、多仓范围。

如果没有任务标识或来源文档,先询问用户。否则从当前仓库、Issue provider 和用户提供的来源中自行发现细节。

真相来源

生成提示词前先读取或检查:

  1. AGENTS.md
  2. .agents/PLANS.md 与相关计划(如存在);
  3. .agents/state/.agents/runs/ 中与本任务相关的本地摘要(如存在);
  4. 任务正文、评论、标签 / 状态和链接的来源文档;
  5. 用户点名的设计文档、接口文档或测试手册。

如果真相来源冲突,协作状态以 Issue provider 为准,执行约束以仓库文档和代码为准。未能自行消解的冲突必须写进生成的提示词。

生成流程

基于当前真相生成目标提示词,不只依赖记忆:

  1. 提取目标、包含范围、排除范围、验收标准、来源文档、验证命令、停止条件、依赖 / 阻塞;
  2. 对复杂任务建议先创建或更新 .agents/plans/YYYY-MM-DD-<slug>.md
  3. 明确每个会写入的仓库、目录和文件范围;
  4. 明确是否允许 commit、push、merge 或外部系统写入;
  5. 给出实现步骤、验证步骤、恢复点和下一步;
  6. 只在任务本身需要时加入 review、live 或外部回写要求,不自动引入额外流程。

状态文件规则

组装提示词后统计字符数:

  • 如果提示词 <= 4000 字符,直接返回完整提示词;
  • 如果提示词 > 4000 字符,把完整提示词写入 .agents/state/GOAL-<ISSUE-ID>.md
  • 如果状态文件已经存在,先读取并保留仍然有效的恢复字段,再更新目标提示词、时间、恢复点和下一步。

默认 .gitignore 会忽略真实 .agents/state/* 文件。如果用户要求提交生成的 Goal 文件,必须先确认项目确实需要跟踪它。

输出规则

  • 只输出生成的完整目标提示词或短启动提示词;
  • 在短启动提示词中使用绝对路径;
  • 不包含隐藏推理;
  • 只生成提示词时,不实施、不提交、不推送、不合并,也不修改 Issue 状态。

Version History

  • 838b539 Current 2026-08-27 17:13

    优化了真相来源读取逻辑,移除硬编码路径并增强动态发现能力;简化了分支门禁与评审策略规则,使流程更灵活通用。

  • e3799d0 2026-07-24 12:23

Same Skill Collection

template/.agents/skills/project-plan-archive/SKILL.md
template/.agents/skills/project-version-release/SKILL.md
template/.agents/skills/test-runbook/SKILL.md

Metadata

Files
0
Version
838b539
Hash
9581d1e8
Indexed
2026-07-24 12:23

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-28 07:58
浙ICP备14020137号-1 $Carte des visiteurs$