issue-flow
Use when a GitHub issue should be driven through clarification recovery, spec-build-test-QA-acceptance, and enforced human review gates with quality gates.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 13
- Forks
- 6
01 前言 Front Matter
- name
- issue-flow
- description
- Use when a GitHub issue should be driven through clarification recovery, spec-build-test-QA-acceptance, and enforced human review gates with quality gates.
- allowed-tools
- Read, Write, ApplyPatch, Grep, Glob, Bash, Question
- argument-hint
- [continue|status|issue <number-or-url>]
- disable-model-invocation
- true
02 资源文件 5
- 参考文档commands/issue-flow.md40.9 KB
- 参考文档manifest.yaml1.9 KB
- 脚本scripts/issue_flow_git.py9.4 KB
- 脚本scripts/issue_flow_state.py9.6 KB
- 脚本scripts/issue_flow_validate_transition.py8.8 KB
03 SKILL.md 正文
Issue Flow
Purpose
Drive one GitHub issue through the full Harnessy delivery lifecycle using the repository's existing skills, mandatory evaluation gates, explicit human review checkpoints, and strategy-aware intake when a standard docs/strategy/ folder exists. GitHub Project metadata is optional enrichment, not a required intake dependency.
Inputs
-
Optional arguments:
continue,status, orissue <number-or-url> -
Template paths are resolved from
${AGENTS_SKILLS_ROOT}/issue-flow/.
Steps
- Follow the command specification in
${AGENTS_SKILLS_ROOT}/issue-flow/commands/issue-flow.mdexactly. - Use existing child skills rather than replacing them.
- Run each new issue cycle in the canonical project-container worktree root
projects/<project-name>/worktrees/<issue_id>_<friendly_name>when viewed from the container, or../worktrees/<issue_id>_<friendly_name>when invoked fromprojects/<project-name>/dev/, derived at runtime via${AGENTS_SKILLS_ROOT}/issue-flow/scripts/issue_flow_git.py. - Persist and reconcile progress through
${SPEC_ROOT}/<epic>/.issue-flow-state.jsonusing portable git metadata only; never store machine-specific absolute worktree paths in tracked state. - Do not advance phases when a required quality gate or human gate is unresolved.
Output
- A phase-by-phase issue delivery run with artifacts, evidence, gate results, and GitHub status updates.
04 同仓库更多 Skills
personal-knowledge
Save sources to the private Harnessy learning library, sync delivered readings, answer questions from saved evidence, browse its wiki, and generate weekly learning reviews.
valid-skill
A valid skill for testing purposes.
unknown-field
A skill with an unknown frontmatter field.
nested-child
Nested skill should be ignored.
root-skill-preferred
Root skill should win.
no-frontmatter
暂无简介