icpg

icpg 技能概览

icpg 技能是做什么的

icpg 技能给代码理解加上一层“WHY 层”。它不只是映射结构，而是把函数、类和模块和它们存在的原因、责任归属，以及是否仍然符合最初意图联系起来。 如果你需要用 icpg 做 Code Review、重构或自治维护，它的核心价值就是在改代码之前减少猜测。

适合谁用

icpg 适合在活跃代码库里工作的工程师和 agent，这类场景里，行为、归属和设计意图比快速扫一遍语法更重要。 当仓库已经出现漂移、任务历史不清晰，或者经常有人问“这段代码当初为什么这么写”时，它尤其有用。

它和别的工具有什么不同

这个技能围绕 ReasonNodes、正式契约和多维度漂移检测展开。 这意味着 icpg 不只是代码地图，更是一个面向任务前分析的决策支持层。 实际收益是更高的变更安全性、更清楚的 review 背景，以及更少那种悄悄违背原始意图的修改。

如何使用 icpg 技能

安装并找到核心文件

先走仓库提供的技能安装流程，然后从 skills/icpg/SKILL.md 开始。 由于这个仓库没有提供辅助脚本或配套目录，技能文件本身就是主要事实来源。 如果你要快速判断是否安装，先读 frontmatter 和前几节，再看其他内容。

把模糊目标变成可用提示

icpg usage 最适合你提供具体任务、目标路径和期望输出形式的时候。 比如可以这样提：“在我改 retry 逻辑之前，先 review src/payments/charge.ts 有没有 intent drift”，或者“为 auth flow 搭建 ReasonNodes，并找出缺失的 ownership link”。 像“分析这个仓库”这类输入太宽泛，通常抓不住这个技能在意图追踪上的优势。

首次使用时建议的工作流

先让它说明目标代码本来的用途，再问有哪些约束或契约在保护它，最后再问哪里最可能出现 drift。 这个顺序符合技能本身的设计，也能帮助 agent 从结构走到意图，再走到风险。 对于 icpg guide 工作流，最好把请求聚焦在一个模块或一组变更上，而不是整个仓库。

先读仓库里的哪些内容

先看 SKILL.md，重点关注用途说明、CLI 示例，以及讲核心原则、标准化的 pre-task 查询、ReasonNode 和 edge types 的部分。 这些内容最可能影响你是否采用这个技能，也最能影响 icpg 在 code review 场景里的输出质量。

icpg 技能 FAQ

icpg 只适合自治 agent 吗？

不适合。icpg 对人和 agent 都有用，但在系统需要可重复的 pre-task 推理时，它的价值最明显。 如果你只是想要一次性的总结，普通 prompt 可能就够了；如果你想要有意图感知的 code review 或变更规划，icpg 会更合适。

icpg 和通用代码提示词相比有什么区别？

通用 prompt 可以概括代码，但 icpg 的目标是在不同任务之间保留意图、归属和 drift 背景。 这使得它在你需要先回答“这段代码是干什么的”再动手改之前，比单纯回答“这段代码做了什么”更有用。

icpg 适合初学者吗？

初学者也能用，但最好的效果来自那些能准确说出文件、功能或变更边界的用户。 如果你刚接触这个仓库，先从单个模块入手，优先问意图、约束和 review 风险，而不是做全系统分析。

什么情况下不该用 icpg？

如果任务很简单、代码彼此隔离，或者你只需要快速的表层解释，就可以跳过 icpg。 如果你说不出目标区域，也提供不了任何变更上下文，它也不是好选择，因为这个技能的价值依赖于把代码映射到某个具体“为什么存在”的原因上。

如何改进 icpg 技能

提供更强的任务上下文

最好的 icpg 结果来自包含变更目标、受影响文件，以及绝对不能破坏什么的提示。 比如，“在新的税务规则之后，review src/billing 是否出现 drift”就比“检查 billing 代码”更强。 这样能帮助技能在 icpg for Code Review 中提取出更准确的 ReasonNodes 和约束。

先问意图，再谈实现

常见的失败模式，是直接跳到修改，却没有先确认这段代码原本想保护什么。 想提升输出质量，可以先要求说明原始目的、当前契约和疑似 drift，然后再要变更方案。 这种顺序能减少非必要回归，也让 review 输出更容易被信任。

用第一轮答案去收窄第二轮

如果第一轮结果太宽泛，就按模块、工作流步骤或 ownership 边界继续缩小范围。 如果答案太浅，就追问缺失的契约、最可能发生 drift 的维度，或者最适合这个任务的标准化 pre-task 查询。 这样迭代，通常比单纯要求更长的回答更能提升信号质量。

让提示词始终贴合技能设计

icpg skill 最强的用法，是让它做 reason tracking、drift detection 和 pre-task analysis，而不只是代码解释。 如果你想获得更好的 icpg usage，就把“完成”意味着什么、你正在考虑哪类改动，以及代码库中哪些部分在范围内写清楚。