Codex issue-writer 技能:从确认范围生成可验收的 GitHub 议题
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/issue-writer/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/issue-writer/`,把核对后的文件保存为 `.agents/skills/issue-writer/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$issue-writer` 并选择同名技能。
中文摘要
把已有计划整理成可直接复制的 Markdown 议题,写明范围、依赖、可观察验收条件和文档影响。
SKILL.md 中文导读
可复现示例
调用 $issue-writer,将下面的虚构事项写成一条早期里程碑的议题草稿。
milestone `Archive preview` | issue `show attachment count` | type UX
in scope show a count in the preview | out of scope file export
fixture `3 attachments` should display `3 attachments` | dependency `preview manifest field`
open question `zero attachments label` | update the preview guide when confirmed工作步骤
- 划定目标、范围和依赖。
- 补充流程、测试、文档与风险影响。
- 写出可观察验收条件,将缺失决定列为问题。
验收方法
保留 `preview manifest field` 依赖,验收用 `3 attachments`。将导出排除在范围外,记录 `zero attachments label` 为待确认。
GitHub 原文 · 更新日期
适用环境
可在本地项目使用技能的 Codex 工作区。提供已规划的事项、范围、依赖与验收记录。
常见问题
缺少界面决策时要怎么落到验收条件?
把已经确认的行为写成可观察要求。界面措辞未定时记录为待确认,并注明影响。