写作与公文
需要将用户故事 Issue 拆解为有序…
在用户故事进入实现前,为其生成按依赖排序、保留验收标准追踪的任务 issue 草案,并在显式确认后才发布。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要将用户故事 Issue 拆解为有序、特定
解决思路
- 收集并确认必需输入:目标 issue 引用(`owner/repo#number` 或 URL)、规划深度(`minimal`/`standard`/`detailed`)、运行模式(`draft-only`/`draft+publish-ready`/`publish-now`);若缺失且阻碍规划,从 `assets/follow-up-questions.md` 中最多提出 3 个聚焦追问。
- 采用默认值:规划深度 `standard`,运行模式 `draft-only`,任何 GitHub 变更前必须同一轮显式确认。
- 使用工具命名格式 `<mcp_server>::<tool>`,例如 `mcp_github::sub_issue_write`。
- 按顺序执行并显式说明假设。先探测首选技能并分类起草模式。
- 若 `fusion-issue-authoring` 和 `fusion-issue-author-task` 均可用,归类为 `orchestrated`:使用完整工作流,由 orchestrator 处理显式发布门禁。
- 若仅 `fusion-issue-author-task` 可用,归类为 `direct-subordinate`:以 `draft-only` 模式使用其模板与保护措施,不执行任何 GitHub 变更,输出草案及由 orchestrator 或用户发布的清晰说明。
- 若两者均不可用,归类为 `inline`:保持 `draft-only` 模式,使用最小内置结构(`Title`、`Problem`、`Scope`、`Acceptance criteria mapping`、`Verification`、`Dependencies`)生成任务草案,并避免直接引用其他技能的 `assets/` 文件。
- 只要 `fusion-issue-author-task` 可用就优先使用它;不要通过直接跨技能文件引用绕过它。
- 不要因缺少首选技能而停止;应优雅降级。
- 研究用户故事:收集标题、正文、验收标准、场景、祖先链、已有子 issue 和相关链接。
- 如果 issue 类型不明确,确认是否按 `User Story` 继续。
- 只在必要时澄清:每批最多问 3 个问题;存在安全默认值时,用显式假设继续。
- 提取规划锚点:结果(Outcomes)、约束与非目标(Constraints and non-goals)、验证点(Verification points)。
- 构建按依赖排序的任务:每个任务包含 objective、scope boundary、deliverable、verification method 和映射的 AC 引用。
- 优先拆成可独立验证的切片。
- 起草前运行 devil's-advocate 审查。检查是否存在以下架构歧义信号:故事、评论或祖先 issue 中提到未解决的设计或架构决策。
- 检查信号:后端与前端任务共享尚未达成一致的隐式 API、数据模型或归属契约。
- 检查信号:发现、研究或对齐任务与具体实现任务并列,但没有明确阻塞关系。
- 检查信号:依赖陈述含糊或循环,例如 `after backend is done`、`when design is ready`。
- 检查信号:组件、API 或数据模型归属不清晰或有争议。
- 若出现 2 个或更多信号:`orchestrated` 模式自动经由 `fusion-issue-authoring` → `agents/devils-advocate.agent.md` 的 interrogator mode 处理,无需用户触发。
- 若出现 2 个或更多信号且为 `direct-subordinate` 或 `inline` 模式:用上述五个信号运行内联 DA checklist;以结构化 `⚠ Ambiguity checklist` 呈现发现,并要求用户在生成草案前解决或显式接受每一项。
- 若出现 0 或 1 个信号:使用 moderate mode,呈现最多 3 个关注点,用户确认后继续。
- 所有模式的发布门禁:在 devil's advocate 确认拆分合理,或用户显式接受所列风险之前,不要发布任务。
- `draft-only` 例外:即使存在未解决歧义也可生成草案,但必须在计划预览顶部输出 `⚠ Ambiguity warning` 块,列出每个未解决项;发布仍被阻塞,直到风险被接受。
- 生成任务 issue 草案:`orchestrated` 模式经由 `fusion-issue-authoring`,issue type 为 `Task`。
- 生成任务 issue 草案:`direct-subordinate` 模式在 `draft-only` 模式调用 `fusion-issue-author-task`,并输出显式发布说明,把最终变更委托给 `fusion-issue-authoring`。
- 生成任务 issue 草案:`inline` 模式使用第 1 步的最小内置结构写入 `.tmp/TASK-<nn>-<slug>.md` 草案。
- 在获得显式发布批准前,将草案保持在本地。
- 生成计划预览:根据 `assets/task-plan-template.md` 写入 `.tmp/USER-STORY-TASK-PLAN-<context>.md`。
- 计划预览包含:summary、traceability、有序任务、草案路径、发布计划、假设、风险。
- 仅在显式确认后发布:要求同一轮显式确认。
- 如果仍有未解决假设,停止发布。
- 将发布执行委托给 `fusion-issue-authoring`,并优先通过 sub-agent 调用创建/更新/链接 task issue。
- 向 `fusion-issue-authoring` 传递必需上下文:`owner`、`repo`、父故事引用、有序任务草案、labels/assignee 意图、依赖顺序。
- 要求 `fusion-issue-authoring` 保持 MCP-first 行为,仅在 MCP 写覆盖不可用时应用 GraphQL fallback。
- orchestrator 的 session-cache 规则适用于所有委托调用:labels、assignee candidates、issue types 每个会话获取一次,并在批次中所有 task issue 间复用。
- 预算意识:发布 N 个任务的 task-planning 约消耗 ~N 次 issue-write mutation + 可选的 sub-issue link mutation;若 N > 5,警告用户速率限制风险并提供分批发布。
- 在 publish 模式不要从本技能直接调用 MCP 写工具。
- 若委托执行返回未解决的 item-level failures,publish 模式硬失败。
- 修复模式:若任务已创建但缺少 `Issue Type` 或父级链接,将修复委托给 `fusion-issue-authoring`,优先 sub-agent 调用。
- 提供逐 issue 修复意图(`set type=Task`、添加缺失父级链接、保留顺序),并要求委托运行返回验证结果。
- 修复模式必须幂等:跳过已正确的 issue,只修复缺失元数据。
- 修复后运行 post-flight verification,并返回可操作的失败。
- 常见失败处理:运行时缺少 `fusion-issue-authoring` 时,保持 `draft-only` 模式,返回 publish-ready 产物及显式交接说明。
- 常见失败处理:委托发布返回部分失败时,返回逐 issue `failed` 状态和确切原因,停止后续变更直到用户确认。
- 常见失败处理:任务 issue 已创建但未链接到父故事时,经由 `fusion-issue-authoring` 触发委托修复,并要求 post-flight verification 输出。
- 常见失败处理:任务存在但 `Issue Type` 缺失或不正确时,经由 `fusion-issue-authoring` 以 `type=Task` 意图触发委托修复并验证结果。
- 常见失败处理:post-flight verification 报告部分失败时,返回逐 issue `failed` 状态和确切原因,停止发布流程,并将未解决项留给用户显式决定。
- 按固定标题顺序返回输出:1. Experimental caveat 2. Story summary 3. Acceptance-criteria traceability 4. Ordered tasks 5. Draft file paths 6. Publish plan 7. Assumptions, risks, and open questions。
- 在发布确认并完成前始终包含 `Status: Awaiting user approval`。
- 对于 `publish-now` 或 `repair` 模式,包含逐 issue post-flight report:issue exists、issue type equals requested type、parent equals expected story number、status(`ok`、`fixed` 或 `failed`)。
- 安全约束:本技能具备 mutation 能力;仓库本地工作流说明与内联指导冲突时,以仓库本地说明优先。
- 安全约束:无显式确认,绝不变更 GitHub 状态。
- 安全约束:没有标记假设时,绝不推断验收标准。
- 安全约束:始终在任务计划中保留 AC traceability。
- 安全约束:在任何发布动作前,将草案保存在 `.tmp/`。
- 安全约束:在 publish/repair 模式,缺少 `Issue Type` 或缺少父级链接一律视为失败,直到 post-flight 检查通过。
- 安全约束:将 mutation/repair 执行委托给 `fusion-issue-authoring`(优先 sub-agent),不要从本技能直接调用 MCP 写工具。
适用边界 · 注意事项
- 不要用于直接代码实现。
- 不要用于 PR review。
- 没有显式确认时不要做 GitHub mutations;若缺少 GitHub MCP 或相关 fusion 技能且不能接受降级,也不适用。