Agent Skills
› Terry-Mao/AICodingFlow
Terry-Mao/AICodingFlow
GitHub分析仓库现有问题、标签和贡献者，自动生成或更新issue分类配置文件(.github/issue-triage/config.json)和代码所有者文件(CODEOWNERS)，用于初始化或优化仓库的问题自动化分流机制。
Install All Skills
npx skills add Terry-Mao/AICodingFlow --all -g -y
Skills in Collection (36)
分析仓库现有问题、标签和贡献者，自动生成或更新issue分类配置文件(.github/issue-triage/config.json)和代码所有者文件(CODEOWNERS)，用于初始化或优化仓库的问题自动化分流机制。
需要为仓库设置首次问题自动化分流
初始化或更新issue triage配置
npx skills add Terry-Mao/AICodingFlow --skill bootstrap-issue-config -g -y
根据用户请求自动创建 GitHub Issue。智能匹配最佳模板，支持 Bug、功能、文档等分类。若涉及安全漏洞，默认走私有披露流程以保护敏感信息，否则提交公开 Issue。
用户要求创建或提交 GitHub Issue
用户希望报告 Bug 或提出新功能建议
用户提及安全漏洞或敏感数据泄露
npx skills add Terry-Mao/AICodingFlow --skill create-issue -g -y
在git-push后创建或更新GitHub PR。流程包括：检查并选择基准分支，本地审查差异并同步；构建标题、正文及Issue链接；优先复用现有开放PR以避免重复，否则新建。确保内容安全、引用准确，并提供PR URL报告。
用户要求创建Pull Request
用户要求更新现有的Pull Request
用户要求打开一个Pull Request
npx skills add Terry-Mao/AICodingFlow --skill create-pr -g -y
诊断PR、分支或运行ID的CI失败，提取错误日志并生成修复计划。支持GitHub Actions URL、Run ID及分支输入，仅用于分析不修改代码。
检查CI状态
排查测试失败
调查PR构建故障
获取CI问题
npx skills add Terry-Mao/AICodingFlow --skill diagnose-ci-failures -g -y
安全高效地创建符合规范的 Git 分支。支持基于 Issue 或自定义命名，自动推断类型并规范化名称。执行最小化检查以防错名、错基或覆盖，默认使用 main 为基准，仅在必要时进行远程同步与冲突检测。
用户请求创建新的开发分支
用户希望基于特定 Issue 生成分支名
用户需要规范化 Git 分支命名格式
npx skills add Terry-Mao/AICodingFlow --skill git-branch -g -y
自动执行原子化Git提交，通过检查差异确定范围，智能分割无关变更，遵循约定式提交规范生成消息，并处理Issue链接。
用户要求提交代码变更
需要清理或整理未暂存的更改
npx skills add Terry-Mao/AICodingFlow --skill git-commit -g -y
在提交后推送分支，通过检查状态确保安全。拒绝保护分支和未暂存更改的推送。处理推送拒绝时请求用户确认重基或强制操作，并报告详细结果。
用户要求推送或发布分支
存在已提交的更改且用户希望推送到远程
npx skills add Terry-Mao/AICodingFlow --skill git-push -g -y
创建隔离的Git工作树以并行处理分支任务。支持基于Issue命名、自动选择基准分支及安全检查。避免覆盖现有资源，排除未提交更改，并生成cd命令以便切换目录。
需要并行开发不同功能或修复bug
用户明确要求创建新的Git工作树
涉及Issue编号的任务分支初始化
npx skills add Terry-Mao/AICodingFlow --skill git-worktree -g -y
为 GitHub PR 或当前分支生成本地静态 HTML 讲解页，通过 D3 可视化展示系统概览、数据流、代码依赖及用户路径，辅助 Reviewer 快速理解变更上下文与架构影响。
用户请求生成 PR 的交互式可视化地图
需要查看代码依赖、数据流或用户路径的图形化展示
希望获得比 Diff 更宏观的系统变更视角
npx skills add Terry-Mao/AICodingFlow --skill pr-walkthrough -g -y
解决Git合并冲突，通过脚本提取未解析路径和冲突片段而非加载完整文件。适用于merge、rebase等操作停止时，或git status显示未合并路径的情况。
执行 merge, rebase, cherry-pick 或 stash pop 遇到冲突
git status 显示存在 unmerged paths
文件中包含冲突标记（<<<<<<< 等）
npx skills add Terry-Mao/AICodingFlow --skill resolve-merge-conflicts -g -y
在本地执行PR审查流程，模拟CI环境准备输入快照并委托给review-pr技能。严格限制只读操作和输出到指定路径，禁止修改代码或推送，确保审查过程安全隔离且结果可验证。
本地代码实现完成后、推送或创建PR前
需要模拟CI审查流程进行本地预检时
npx skills add Terry-Mao/AICodingFlow --skill review-pr-local -g -y
在本地执行规范审查工作流，模拟CI环境准备输入快照并委托给review-spec。严格禁止修改仓库文件或推送代码，仅通过review.json报告问题，确保审查过程安全且与CI一致。
本地完成规范编写后
准备提交或创建PR前
npx skills add Terry-Mao/AICodingFlow --skill review-spec-local -g -y
驱动规范优先工作流，在实现重大功能前编写并维护产品与技术规范。适用于存在歧义、代码量大或跨层级的复杂变更，通过Agent生成规范文件至源码控制，提升质量与可审查性。
开始重大功能开发
规划Agent驱动的实现
用户要求将规范和科技文档检入源代码控制
npx skills add Terry-Mao/AICodingFlow --skill spec-driven-implementation -g -y
用于为仓库中重要的用户面向功能编写产品规格说明书。聚焦于行为、UX和验证，确保需求无歧义以指导实现。包含摘要、问题、目标、非目标及详细用户体验描述等结构，并规范了Figma参考的引用方式。
用户请求编写产品规格书或PRD
在实现前定义功能行为
功能重大或行为模糊需要书面规范
npx skills add Terry-Mao/AICodingFlow --skill write-product-spec -g -y
用于为仓库中重要功能编写技术规格说明书，将产品意图转化为贴合现有代码库的实施计划。适用于多模块、架构决策复杂或需扩展性的场景，指导Agent进行代码调研并输出结构化技术方案。
用户要求编写技术规格说明
用户要求制定实施计划
用户要求撰写与产品规格相关的架构文档
npx skills add Terry-Mao/AICodingFlow --skill write-tech-spec -g -y
在PR审查时，对比代码实现与spec_context.md中的规范上下文。识别实质性偏差（如缺失行为或矛盾），并将结果整合至review.json中，作为常规代码审查的补充。
PR审查阶段且存在spec_context.md文件
需要验证代码实现是否符合产品或技术规格
npx skills add Terry-Mao/AICodingFlow --skill check-impl-against-spec -g -y
将GitHub Issue转化为产品规格说明书。基于本地共享工作流，读取Issue上下文及评论，生成聚焦用户行为与需求的product.md文件至指定路径，不提交代码或创建PR。
需要将GitHub Issue转化为产品规格文档
准备产品需求文件但不执行代码提交
npx skills add Terry-Mao/AICodingFlow --skill create-product-spec -g -y
将GitHub Issue转化为技术规格说明书。基于共享工作流，读取Issue上下文及产品规范，分析代码现状，生成位于specs目录下的tech.md文件，明确实现方案、风险及验证策略，不执行代码提交。
需要将GitHub Issue转换为技术设计文档
请求生成特定Issue编号的技术规格说明
npx skills add Terry-Mao/AICodingFlow --skill create-tech-spec -g -y
作为核心去重技能的补充，提供仓库本地化的重复检测规范。仅允许在核心技能允许的覆盖类别内进行专业化配置，如已知重复集群和标题描述规范化，严格遵循核心算法与输出契约，禁止修改核心逻辑或执行副作用操作。
需要进行仓库特定的重复问题检测时
需要应用仓库本地的重复模式或文本规范化规则时
npx skills add Terry-Mao/AICodingFlow --skill dedupe-issue-repo -g -y
通过比对标题和描述相似度，检测GitHub重复Issue。需至少2个候选项匹配才标记，优先保证精确度，避免误报。
需要识别GitHub重复Issue时
收到包含新Issue及候选Issue列表的工单处理流程时
npx skills add Terry-Mao/AICodingFlow --skill dedupe-issue -g -y
基于GitHub Issue实施代码，通过本地共享的implement-specs工作流生成实现差异和交接元数据。输入Issue上下文、规范及评论，输出摘要和PR元数据，不直接创建PR。
用户要求根据提供的GitHub Issue描述实现功能
需要为特定Issue生成实现差异和PR元数据文件
npx skills add Terry-Mao/AICodingFlow --skill implement-issue -g -y
用于在产品和科技规范获批后，执行功能实现。核心目标是构建功能并保持代码与规范同步更新，通常将二者合并在同一PR或分支中，确保审查聚焦于最终交付的功能。
产品和技术规范已获批，需要开始编码实现时
需要在开发过程中保持代码与文档规范的一致性时
npx skills add Terry-Mao/AICodingFlow --skill implement-specs -g -y
分析近期代码变更并生成产品更新报告。适用于总结已发布功能、运行定时报告或分析提交记录，输出至docs/updates/目录，不直接修改权威文档。
用户要求总结已发布的变更
运行定时的产品更新报告
分析最近的提交以生成可报告的产品和工程更新
npx skills add Terry-Mao/AICodingFlow --skill product-change-report -g -y
分析Issue或PR是否改变长期产品知识，决定是否需要更新docs/product。输入上下文文件，输出决策JSON。规则涵盖概念、工作流、权限等变更需更新，证据不足时标记不确定，无影响则不操作。
收到包含产品逻辑变更的Issue或实现PR
需要判断代码改动是否影响长期产品文档
npx skills add Terry-Mao/AICodingFlow --skill product-docs-sync -g -y
维护产品LLM知识库，从原始文档提取摘要与概念，生成结构化Wiki。确保内容可溯源、易查询，并处理不确定知识的暂存审核，辅助Agent高效获取准确产品信息。
需要整理或更新产品文档结构时
从原始产品文档生成知识摘要或概念页时
维护产品知识库的索引和编译日志时
npx skills add Terry-Mao/AICodingFlow --skill product-wiki -g -y
作为核心 review-pr 技能的仓库特定辅助指南，定义代码审查重点与安全边界。涵盖技能文件规范、Git 操作安全、CI/CD 稳定性及文档一致性检查，禁止覆盖核心工作流，并明确自我演进的权限范围。
执行 PR 代码审查
检查仓库特定的技能文件与自动化脚本
npx skills add Terry-Mao/AICodingFlow --skill review-pr-repo -g -y
从本地快照文件离线审查GitHub PR，生成并验证review.json。涵盖代码正确性、安全及文档一致性检查，支持仓库特定规范与安全补充审查，严格遵循契约约束，不修改外部文件或调用GitHub API。
需要离线进行PR代码审查时
CI流水线或机器人自动执行PR评论任务时
npx skills add Terry-Mao/AICodingFlow --skill review-pr -g -y
作为核心 review-spec 技能的仓库级辅助指南，用于提供特定于仓库的规格审查指导。重点检查规格的可执行性、需求与示例的一致性，并处理全局性问题。严禁覆盖核心工作流或共享审查契约。
需要针对特定仓库进行规格文档审查时
核心 review-spec 技能调用以获取仓库特定偏好时
npx skills add Terry-Mao/AICodingFlow --skill review-spec-repo -g -y
用于审查仅包含 specs/ 目录下文档的 PR。基于快照文件评估规格说明书的完整性、清晰度、可行性及一致性，输出 review.json。若含非 specs 文件则提示范围外并拒绝代码审查。
PR 变更文件全部位于 specs/ 目录
需要评估产品或技术规格文档质量
npx skills add Terry-Mao/AICodingFlow --skill review-spec -g -y
作为review-pr的补充，审计PR中的代码级安全风险。检查输入验证、输出编码、认证授权、密钥管理及依赖安全等问题，并将发现折叠至review.json中，不生成独立报告。
用户请求对代码或混合类型PR进行安全审查
在应用review-pr技能时自动触发以增强安全性检查
npx skills add Terry-Mao/AICodingFlow --skill security-review-pr -g -y
作为review-spec的补充，审查规格说明PR中的设计级安全风险。评估威胁面、认证授权、敏感数据及滥用场景，并将发现折叠至review.json，不生成独立报告或进行代码级审查。
审查规格说明（Spec）类型的Pull Request
与base spec review同时执行
npx skills add Terry-Mao/AICodingFlow --skill security-review-spec -g -y
作为核心分类技能的补充，提供仓库特定的Issue分流指导。规范症状与假设区分、跟进提问策略，明确ready-to-spec/implement标签使用条件，并引用配置管理标签体系，确保分类符合核心契约与安全规则。
用户请求对GitHub Issue进行优先级排序或分类
需要为特定仓库的Issue添加生命周期标签
在Issue处理过程中判断是否具备编写规格说明的条件
npx skills add Terry-Mao/AICodingFlow --skill triage-issue-repo -g -y
分析新提交的GitHub Issue，通过检查代码、评估可复现性及推测根因，生成结构化初筛结果。不直接修改GitHub，仅输出分析结论与必要追问。
收到包含Issue详情和触发评论的提示
通过@bot /triage命令请求处理
npx skills add Terry-Mao/AICodingFlow --skill triage-issue -g -y
分析聚合的重复关闭证据，识别稳定的重复集群，生成针对仓库的简明去重指导更新建议。仅输出到指定目录，由运行器执行后续操作，确保内容安全且基于结构化数据。
需要更新去重技能指南时
收到聚合后的重复问题反馈JSON数据时
npx skills add Terry-Mao/AICodingFlow --skill update-dedupe -g -y
将人工对机器人PR审查的反馈转化为仓库本地审查技能指南。通过识别重复模式，更新SKILL.md以优化未来审查规则，仅处理人类反馈，由Runner执行实际写入。
收到包含人工审查反馈的JSON数据
需要根据历史人工反馈优化本地代码审查规则
npx skills add Terry-Mao/AICodingFlow --skill update-pr-review -g -y
该技能用于将维护者对近期问题分类的重复修正转化为仓库本地的triage指南更新。它分析聚合反馈，识别稳定模式，在满足至少两个独立案例时生成建议，并将输出写入指定目录供Runner执行。
收到聚合后的维护者分类反馈JSON数据
需要基于历史修正优化本地Issue分类指引
npx skills add Terry-Mao/AICodingFlow --skill update-triage -g -y
