repo-scan-2-jira
基于证据的代码仓库扫描工具，自动生成Jira工单。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：repo-scan-2-jira。 它的用途是：基于证据的代码仓库扫描工具，自动生成Jira工单。 完整的 Skill 内容见：https://321skill.com/skills/repo-scan-2-jira/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用repo-scan-2-jira技能，扫描frontend模块下src/components/Checkout目录，找出所有TODO、FIXME和可能的bug，并为ABC项目生成Jira工单。” 它会引导你配置参数文件，然后执行扫描，最终输出一个包含所有发现问题的、可直接导入Jira的JSON文件。
介绍
RepoScan2Jira是一款专为开发团队设计的代码扫描工具，旨在将代码库中的潜在问题（如TODO注释、Bug、文档不一致、性能风险）自动转化为可直接导入Jira的、结构化的工单。它通过聚焦扫描范围、提取具体证据，避免了传统扫描工具产生的噪音和无意义工单。
使用时，用户只需编辑一个JSON配置文件，指定要扫描的代码模块、路径、关注的问题类型和Jira项目信息，然后运行扫描命令即可。工具会执行有范围的搜索，收集信号，并生成符合预设输出格式的JSON文件，其中包含工单标题、描述、证据和验收标准等所有必要信息。
该工具非常适合需要将技术债务、代码质量问题系统化追踪到项目管理工具（如Jira）的团队。这包括项目经理、技术负责人、全栈开发者和运维工程师，他们希望将代码审查发现或遗留问题自动化地纳入开发流程。
建议使用前仔细阅读SKILL.md中的非协商性规则，确保理解其“证据优先”和“范围限定”的核心原则。初次使用应从一个小的、明确的范围（如单个功能模块）开始，以验证输出质量，并根据团队需求调整信号关键词和置信度阈值。
核心特点
与同类扫描工具相比，它严格限定扫描范围，只生成带有具体代码证据的工单，并通过生成稳定的去重键来避免重复创建相同问题的工单，有效防止工单泛滥。
注意事项
不适合用于无明确代码路径或需要高度主观判断、缺乏直接代码证据的探索性代码审查。
常见问题
如何避免扫描产生大量重复或无意义的工单？
工具通过生成基于代码位置和问题类型的稳定去重键，并允许设置最小置信度阈值来过滤低质量信号，从而有效避免工单泛滥。
生成的工单可以直接导入Jira吗？
是的，工具输出的JSON格式符合Jira批量创建工单的API要求，可以直接通过Jira的导入工具或API进行批量创建。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/repo-scan-2-jira/raw/index.md 读取 repo-scan-2-jira 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/repo-scan-2-jira/raw/index.md（查看排版版本）