issue-to-agent

issue-to-agent 是做什么的？

当用户要求 Codex 从 GitHub Issue、Issue URL、OWNER/REPO#123、粘贴的 Issue 文本或本地 Issue 文件中准备实施计划、任务包或代理交接时，使用此技能。

目标

创建一个紧凑、可操作的任务包，使编码代理无需重新发现基本上下文即可执行。

必要输入

• Issue 来源：本地 Issue 文件、粘贴的 Issue 文本、标准输入、GitHub Issue URL 或 OWNER/REPO#123。
• 本地仓库路径。如果用户未指定，默认使用当前工作目录。

工作流程

1. 确认你位于目标仓库中；如果无法推断，则询问仓库路径。

2. 如果 CLI 已安装，运行：

   issue-to-agent ISSUE_SOURCE --repo REPO_PATH --output ISSUE_AGENT_TASK.md
   

3. 如果用户需要自动化输出，也运行：

   issue-to-agent ISSUE_SOURCE --repo REPO_PATH --format json --output ISSUE_AGENT_TASK.json
   

4. 如果用户需要维护者可读的报告，运行：

   issue-to-agent ISSUE_SOURCE --repo REPO_PATH --format html --output issue-agent-task.html
   

5. 在呈现生成的任务包之前先阅读它。检查可能的文件、命令、验收标准和风险是否合理。

6. 如果文件排名较弱，使用仓库搜索检查相关术语并指出其弱点。不要假装任务包是权威的。

7. 返回生成的任务包路径并总结：

   • Issue 摘要
   • 可能涉及的文件
   • 建议的命令
   • 验收标准
   • 风险区域
   • 剩余的未解决问题

边界

• 除非用户明确要求，否则不要实施 Issue。
• 除非被要求，否则不要发布、推送或评论 GitHub。
• 不要调用 LLM 或外部服务。issue-to-agent 是本地优先的；GitHub Issue 加载仅使用本地 gh CLI。
• 将安全、认证、计费和迁移相关的 Issue 视为高风险，并在代理执行前建议人工审查。

良好的输出格式

已创建 ISSUE_AGENT_TASK.md。

可能涉及的文件：
- src/...
- tests/...

运行：
- ...

风险：
- ...