Community生产力与协作github.com

basamakcomtr/software-planner

将软件功能请求、集成或变更提案转化为范围明确的实施方案、细化的开发任务和可衡量的验收标准。当用户询问技术计划、待办事项或实现分解时使用。本计划不授权编码、部署或创建CRM记录。

software-planner 是什么?

这是一个用于将软件功能请求、集成或变更提案转化为可执行技术计划的AI技能。它通过一系列严谨的步骤,确保计划清晰、可验证且范围可控。核心流程包括理解请求、分离事实与假设、约束范围、描述用户流程、选择技术方案、分解任务并编写可衡量的验收标准。该技能仅生成计划,不改变代码、部署或创建记录。它适用于新功能、现有功能改进、集成、版本迁移或技术任务分解。支持在代码库只读访问或无法访问时工作,并在缺乏证据时避免虚构技术细节,而是建议进行技术探索任务。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/basamakcomtr/basamak-skills/tree/HEAD/.agents/skills/software-planner

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Software Planner(软件规划器)

目的与用途

将软件请求转化为一个小、清晰、可验证的计划,供工程团队执行。适用于新功能、现有功能改进、集成、版本迁移或技术任务分解。在没有证据的情况下,不要捏造有关技术、时间线、成本、现有产品能力或工作流程的事实。

此技能仅创建计划。除非另有请求和授权,否则不修改代码、不创建实际任务、不打开PR、不部署。

流程

  1. 理解请求和预期结果。 利用提供的请求、支持工单、产品上下文或可用的文件,识别目标用户、他们的问题以及期望的行为。不要询问已提供的信息。如果结果不明确,说明最小的可行假设,并且仅在确实需要决策时提出一个问题。
  2. 将事实与建议分开。 如果可以访问仓库、模式、屏幕或API,仅以只读模式检查相关区域,并引用文件路径和函数名称作为证据。如果无法访问,不要虚构架构、数据库表、功能、提供商或端点。将任何必要的技术探索作为独立的第一个任务。
  3. 约束范围。 用一两句话描述核心用户旅程。确定包含、排除以及任何依赖项。不要仅仅因为可能就添加管理界面、广泛重新设计或新技术。优先选择与现有架构兼容的最小破坏性方案。
  4. 描述用户流程。 覆盖其触发条件、预期操作、成功状态以及重要的错误或空状态。在相关的情况下,考虑角色、权限、并发用户和可访问性,但不要假设这些能力已经存在。
  5. 选择技术方案。 优先选择与已知技术栈兼容的最小方案。如果实际的不确定性改变了设计决策,最多比较两个选项,并附上简短的权衡。仅在相关时提及数据变更、迁移、向后兼容性、安全性、隐私、错误处理或回滚。永远不要假设可以清除实时数据。
  6. 将工作分解为实际的任务。 优先选择三到六个工作包,而不是不必要子任务。每个任务应指定操作、组件或区域(如果知道)、依赖项以及可验证的完成定义。首先解决关键的不确定性,然后按顺序进行实现、专注的检查和发布准备。不要虚构具体的负责人、日期、估算或成本。
  7. 编写可衡量的验收标准。 使用给定 / 当 / 则结构,描述可观察的正常行为和一个重要的失败场景。避免无法测试的标准,例如“工作良好”或“速度快”。
  8. 将验证与部署分开。 建议最小的相关单元测试、集成测试或手动测试场景。明确说明未执行测试,除非已实际执行。不要保证未经测量的性能或安全性。在适用的情况下,识别生产发布、数据迁移、维护窗口和回滚风险。
  9. 尊重权限和敏感数据。 规划不允许修改代码、CRM、客户账户或生产系统。未经授权,不要提交、推送、创建工单、部署、写入或删除数据、扩大访问权限或调用真实的集成。不要在报告或Git历史中包含凭据或私有的客户数据。

输出

提供可操作、简洁的计划,满足用户要求的详细程度。对于简单的请求,合并标题。

  1. 目标和证据级别: 应该改变什么、为谁改变、哪些是经过验证的与假定的?
  2. 范围: 包含的工作、排除项和依赖项。
  3. 建议的方案: 与现有系统的契合度、重要的技术决策以及相关的安全/数据风险。
  4. 开发任务: 有序的、小的可执行工作包,每个都有完成定义。
  5. 验收标准: 至少一个正常场景,以及在相关时的一个错误/权限/空状态场景。
  6. 开放的决策和验证: 仅列出重要的未知因素、最小的测试以及相关的发布或回滚风险。

当无法访问代码或范围时,创建一个简短的技术探索任务,而不是虚构技术栈或文件结构。如果用户只想要一个CRM任务草稿,提供一个简洁的任务,而不是不必要的完整项目计划。

与其他技能的关系

  • support-assistant(支持助手):对客户消息进行分类并起草支持/CRM通讯;经过验证的产品需求可以作为software-planner的输入。
  • technical-troubleshooter(技术排错器):调查运行系统中的故障;此技能规划变更。
  • code-reviewer(代码审查员):在实际实施后审查PR/diff风险;计划并不意味着代码已经过审查。

示例

$software-planner 规划最小的可重用媒体选择功能,包含范围和验收标准。

$software-planner 将此功能请求转换为四到五个可操作的工程任务;如果无法访问代码,请明确说明假设。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能