用aihero.dev的自带技能写第一份需求规格，你可以在装了对应技能的编码助手里打开项目，先运行 setup-matt-pocock-skills 配置本地工单，再用 grill-with-docs 捋清楚业务规则，最后调用 to-spec 整理好规格存下来。拿待办归档功能举例，全部做完之后，你可以直接从生成的规格里核对默认列表、历史视图还有本轮开发的覆盖范围。
用 AIHero.dev 写规格前要准备什么？
提前准备一个你有编辑权限的项目，以及已经装好初始化、需求对齐、规格生成三类技能的编码助手就行。
选一个你有权限修改的待办类应用，也可以直接新建个空目录用来练手。先确认助手的工作目录指向正确，并且已经在 mattpocock/skills 里安装好了初始化、需求对齐和规格生成这三个技能。如果用的是已有项目，先让助手读取当前的任务状态和默认列表逻辑。空目录也能练需求讨论，只是要提前说明现在还没有可直接核对的已实现功能。
确认练习目录
pwd git rev-parse --show-toplevel
在已有的Git仓库里跑这两条命令，确认助手打开的就是你要用来练习的仓库。如果是刚新建的空目录还没初始化Git，第二条命令可能会报错，这时候只需要核对 pwd 的输出就行，同时在当前会话里说明这是空白练习环境。
怎样让规格留在本地项目？
调用 setup-matt-pocock-skills 的时候选本地Markdown跟踪器，批准写入操作之后，去检查 docs/agents/issue-tracker.md 里的跟踪器设置是否正确。
运行 setup-matt-pocock-skills，把工单跟踪器设置成本地Markdown，过一遍助手准备写入的配置，确认所有工单都存在本地，同时核对好领域文档的存放位置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认完配置，检查 docs/agents/issue-tracker.md 里有没有记录本地跟踪器配置，docs/agents/domain.md 里有没有写清楚术语表和决策目录的位置，还要核对 AGENTS.md 或 CLAUDE.md 里的技能配置入口。要是缺文件，先看是不是你还没点批准初始化写入，或是助手打开的仓库不对。
初始化时明确选择本地 Markdown
为当前仓库运行 setup-matt-pocock-skills。工单跟踪器选本地 Markdown，请先展示将写入的配置，再等我确认。
批准写入之后先核对一遍配置，再开始写规格。按照官方本地跟踪器的约定，一个功能对应一个单独目录，生成的规格位于 .scratch/。这次练习你可以把功能名定为 task-archive。
怎么把讨论整理成第一份需求规格？
先用 grill-with-docs 把用户行为和功能范围全部确认清楚，再调用 to-spec 把已经敲定的结论整理成正式规格。
赋予Agent实时语音交互能力。与Claude对话！超快TTS文字转语音，约90毫秒低延迟音频输出。
在当前会话里直接输入「用 Grill with Docs 帮我讨论待办归档。归档后从默认列表隐藏，历史仍可在归档视图查看，恢复留给以后」。让助手核对现有状态和过滤规则，确认完所有范围之后，再调用 to-spec 整理本轮的讨论内容。工具会自动用之前配好的跟踪器存文件，保存之前你可以先要求助手核对一遍规格里的验收入口。
先确认四条规则，再调用规格技能
- 归档入口只操作单条任务。
- 归档后默认列表隐藏这条任务。
- 归档视图可以查阅历史。
- 恢复、永久删除和批量归档留到后续。
用 to-spec 整理刚才确认的任务归档需求。功能目录用 task-archive，请先核对可用的验收入口，并按当前本地跟踪器保存。
哪怕是课程管理这类其他项目，也可以先让助手回顾之前已经讨论过的行为，再核对剩下还没确认的范围。
怎样判断归档规格可以交给开发？
检查规格里有没有写清默认列表、归档视图的规则，以及本轮的开发边界。验收时要能完整走完归档单条任务的流程，在两个视图里分别核对结果。
打开助手提示的文件保存路径，确认写出来的规格能让开发者照着复现验收流程。拿这次的练习来说，照着规格做完，要能顺利归档一条任务，确认它从默认列表消失，再打开归档视图查到这条任务还在。要是规格里漏写了恢复功能的范围，回到之前的对话里补全约定，再更新规格就行。
规格也可以保存到在线跟踪器里。作者把课程管理功能的规格写入 GitHub Issue #642，分别记录问题背景和对应的解决方案。
验收时逐项读文件
从仓库根目录打开 .scratch/task-archive/spec.md，逐行核对文件标题、用户行为、范围和验证条件。如果助手生成的时候选了其他功能目录，以它实际提示的路径为准。要是找不到生成的文件，先回去检查跟踪器设置，看看是不是还有等待你确认的步骤没走完。
