Agent Skills
› SisyphusSQ/harness-template
› issue-goal-prompt
issue-goal-prompt
GitHub根据Issue或文档生成可执行的目标提示词,提取范围、验收标准及步骤,支持状态持久化。
Trigger Scenarios
需要整理任务上下文为清晰目标时
用户请求生成任务提示词或启动指令时
Install
npx skills add SisyphusSQ/harness-template --skill issue-goal-prompt -g -y
SKILL.md
Frontmatter
{
"name": "issue-goal-prompt",
"description": "从 Linear、GitHub、GitLab、仓库文件或设计文档生成可执行目标提示词;适用于需要把任务上下文整理成清晰目标、范围、步骤和验证入口的场景。"
}
任务目标提示词
为任务生成具体目标提示词。除非用户明确要求继续实施,否则只生成提示词,不执行任务实现。
必要输入
issue_id、任务链接或仓库内任务文件路径;- 可选约束:执行模式、范围限制、来源文档、验证策略、分支 / 提交 / 推送边界、多仓范围。
如果没有任务标识或来源文档,先询问用户。否则从当前仓库、Issue provider 和用户提供的来源中自行发现细节。
真相来源
生成提示词前先读取或检查:
AGENTS.md;.agents/PLANS.md与相关计划(如存在);.agents/state/、.agents/runs/中与本任务相关的本地摘要(如存在);- 任务正文、评论、标签 / 状态和链接的来源文档;
- 用户点名的设计文档、接口文档或测试手册。
如果真相来源冲突,协作状态以 Issue provider 为准,执行约束以仓库文档和代码为准。未能自行消解的冲突必须写进生成的提示词。
生成流程
基于当前真相生成目标提示词,不只依赖记忆:
- 提取目标、包含范围、排除范围、验收标准、来源文档、验证命令、停止条件、依赖 / 阻塞;
- 对复杂任务建议先创建或更新
.agents/plans/YYYY-MM-DD-<slug>.md; - 明确每个会写入的仓库、目录和文件范围;
- 明确是否允许 commit、push、merge 或外部系统写入;
- 给出实现步骤、验证步骤、恢复点和下一步;
- 只在任务本身需要时加入 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


