用途
propose-feature 用于把零散的想法或粗略笔记转化为一份可独立阅读、可评审的 gcx 功能提案。它面向功能请求、改进建议和拟议命令,按照通用的功能提案表单组织内容,最终产出可评审的草稿;或在获得授权后提交为 issue。它可以服务于需要提案草稿但贡献流程不强制要求提案的工作。
主要能力
- 依据 VISION.md 判断产品契合度,依据 CONSTITUTION.md 核对不变量。
- 阅读相关代码和现有命令帮助,了解当前行为与附近能力。
- 搜索已有 issue 和 PR,查找重复项或可复用的决策。
- 在影响可行性时调研相关公开 API 或依赖,并明确说明未知的 API 就绪度、权限、数据可用性等可行性缺口。
- 区分观察事实、用户报告的需求和拟议行为;当证据与想法冲突或受不变量限制时,说明冲突并调整提案。
- 通过简短访谈聚焦真正影响提案的问题:谁遇到问题、体现问题的场景、范围在哪里停止、完成的标准是什么;可用小批量问题附带推荐答案和权衡。
- 按表单起草三个必需部分:Problem、Proposed UX、Acceptance criteria;可选补充 Scope and open questions、Implementation notes。
- 核对每个现有命令、标志和文件路径;将新命令和新行为标注为拟议内容。
- 展示完整草稿、标题、issue 类型(Feature)、标签(action/needs-triage)及拟议指派人,修订至可批准状态。
使用方式
技能以简短访谈推进:复用已有决策和证据,仅询问会改变提案的内容;在等待回答期间可继续独立调研。当问题、拟议 UX 和可检验的验收标准清晰后即停止访谈,未解决的设计选择记为开放问题。草稿完成后展示全文供审阅。
提交边界
只有用户指令授权具体 issue 和目标位置时才发布,并对指派、链接和修改其他共享记录适用相同的授权边界。授权提交时:使用 gh issue create --body-file 创建 issue 并应用表单标签;通过 GraphQL updateIssueIssueType 变更将类型设为 Feature,从组织的 issueTypes 查询现有序号,保留组织级类型管理;回读 issue 正文和元数据,报告 URL 及其他经授权的变更。未获授权时交回私有草稿。
适用场景
- 将产品想法整理成可供维护者评审的功能提案。
- 为 gcx 的新命令或行为改进起草 UX 与验收标准。
- 在提交 issue 前排查重复提案与可行性问题。
限制与注意事项
仓库是公开的,须遵循 CLAUDE.md 中 GitHub Issues 部分的匿名化规则,只使用适合公开评审的公开证据或独立开发材料;受限研究应留在检出目录之外,删除链接或署名并不能使内部发现变得可发布。提案可保留未解决的可行性问题交由维护者评审。提案接受后的下一步是维护者评审,之后按贡献指南遵循新功能 RFC 要求与产品团队例外;开发者自行选择实现工具和规划方式。