用途:To Issues 把计划或 PRD 转换为可独立执行的垂直切片工单,适合功能拆解、并行工作项准备,以及为 AI 代理(AFK)或人工开发者(HITL)分配任务。不适用于从零编写 PRD(改用 to-prd)、评估既有工单(改用 triage)或无实现工单的规划(改用 task-planning)。
核心原则:每个切片是贯穿模式、API、UI、测试各层的窄而完整的路径,完成后可独立演示。反例是横向拆分(先加所有数据库表,再加所有 API,再加所有 UI),正例是纵向切片(“用户可创建任务”,含 schema、API、UI、测试端到端)。
工单类型:HITL 需人工交互,如架构决策、设计评审、外部访问、手动测试;AFK 无需人工输入即可实现并合并,应尽量优先 AFK。
流程:先收集上下文,读取对话中的计划或相关工单,理解完整范围;再探索代码库,使用 CONTEXT.md 中的领域术语命名,避免重复工作;随后起草垂直切片,每个切片是一个可独立完成的用户价值单元、贯穿相关各层、按依赖排序并标注 HITL/AFK;发布前向用户确认粒度、依赖顺序、是否合并或拆分、分类是否调整;最后按依赖顺序发布到工单跟踪系统。
工单使用标准模板,含 Context、Acceptance Criteria(可测试的验收项)、Implementation Notes(关键决策与约束)、Type(HITL 或 AFK),并添加类别标签(bug/enhancement)与状态标签(needs-triage 或 ready-for-agent/ready-for-human)。执行时先识别任务触发与预期输出,按步骤自上而下执行,验证输出后再进入下一步,记录阻塞与回退路径。建议先用小范围试用再扩展,输出应确定且可审计,优先小步可回滚改动,显式记录假设。参考资料包括 .agent-skills/skill-standardization/SKILL.md 与校验脚本 .agent-skills/skill-standardization/scripts/validate_skill.sh。具体安装命令与收费信息暂未提供。