IssueSmith
用 GitHub Issue 驱动 AI 开发闭环：从想法到合并，四步五指令。
核心理念
Issue 是唯一真相来源。 每个变更绑定一个 Issue，承载需求、验收标准和任务拆分。用 worktree 隔离开发，用验证和 review 作为合并门禁。临时 plan 不入库。
快速开始
安装
Claude Code：
注册 marketplace：
claude plugin marketplace add membphis/issuesmith
安装插件：
claude plugin install issuesmith@issuesmith-marketplace
安装后 /ism:explore、/ism:start 等指令即可使用。
OpenCode：
在目标项目的 opencode.json 中添加：
{
"plugin": ["issuesmith@git+https://github.com/membphis/issuesmith.git"]
}
重启 OpenCode 即可使用。也可以直接在 OpenCode 中告诉它：
Fetch and follow instructions from https://raw.githubusercontent.com/membphis/issuesmith/refs/heads/main/.opencode/INSTALL.md
前置条件
- GitHub 仓库 + Claude Code 或 OpenCode
git worktree（Git 自带）+ gh CLI
第一步：创建 Issue
把想法转化为结构化 Issue。
/ism:explore
思考伙伴模式。探索问题空间、对比方案，不写代码。
/ism:create
逐节引导生成 Issue（Background → Goal → AC → Tasks），确认后发布。
第二步：启动开发
基于 Issue 创建隔离的 worktree 和分支。
读取 Issue #3，自动推导分支名，创建 worktree 并安装依赖。
/ism:start 3
第三步：执行开发
在 worktree 内按 Task Checklist 逐项实现。
前置校验 worktree 环境，拆解任务，测试先行，逐项实现。手动调用时任务间暂停确认，完成后询问是否进入第四步。
/ism:implement
第四步：收尾（一键入口）
智能收尾，也可一键到底。自动检测当前状态：
- 无 worktree → 引导提供 Issue 编号 → 自动创建 worktree → 实现 → PR
- 有 worktree 但未完成 → 自动补齐剩余任务 → PR
- 已完成 → 最终验证 → AC 检查 → 推送 → 创建 PR → CI 等待 → AI review
/ism:finish
/ism:finish <N>
辅助指令
/ism:verify
运行测试和 lint，证据先于声称。
/ism:code-review
对当前分支做系统化 review，分级输出。
配置
将 templates/AGENTS.md 复制为 AGENTS.md（或 CLAUDE.md / GEMINI.md），让 AI 按 IssueSmith 流程工作。
项目结构
issuesmith/
├── README.md # 项目入口
├── AGENTS.md # AI 项目规则
├── .claude-plugin/
│ └── plugin.json # Claude Code 插件清单
├── commands/ # /ism:* 指令入口（OpenCode）
├── skills/ # 内置 skill（Claude Code / OpenCode 通用）
├── .github/
│ ├── ISSUE_TEMPLATE/ # Issue 模板
│ └── pull_request_template.md
├── templates/
│ └── AGENTS.md # 可复制的 AI 规则模板
├── examples/
│ └── README.md # 端到端示例
└── docs/
├── workflow.md # 详细流程
├── adr-policy.md # ADR 策略
└── worktree-guide.md # Worktree 指南
许可证
MIT
