From cc-investigation
Guides users through initial setup of team configuration, evidence strategy, integration checks, and preferences. Supports pause/resume, upgrade merging, and incremental updates.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cc-investigation:cold-start-interviewThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
首次安装 cc-investigation 后的设置向导。在一次对话中完成所有配置,让插件从"通用模板"变成"你的调查工具"。
首次安装 cc-investigation 后的设置向导。在一次对话中完成所有配置,让插件从"通用模板"变成"你的调查工具"。
| 场景 | 行为 |
|---|---|
| 插件安装后首次触发(SessionStart hook) | 自动提示运行 |
用户主动运行 /cc-investigation:cold-start-interview | 进入状态检测 |
技能检测到 team-profile.md 不存在或含 [PLACEHOLDER] | 引导用户运行此命令 |
用户运行 --check-integrations | 仅检查集成状态,不重新访谈 |
用户运行 --redo | 重新完整访谈,覆盖现有配置(先展示 diff) |
每次运行时,先检查配置路径的四种状态,然后分支:
~/.claude/plugins/config/cc-investigation/team-profile.md 的状态:
DOES_NOT_EXIST → 进入 Phase 1(全新设置)
├── evidence-policy.md 也不存在 → 标记为"可选,稍后设置"
PAUSED → 提示用户"上次中断于[章节],是否继续?"
├── 用户选择继续 → 跳转至中断点
├── 用户选择重来 → 进入 Phase 1
HAS_PLACEHOLDER → 提示"配置不完整,继续补全或重来?"
├── 用户选择补全 → 逐个定位 [PLACEHOLDER] 位置并引导填写
├── 用户选择重来 → 进入 Phase 1
READY → "配置已就绪,是否需要:
├── --redo 重新完整设置
├── --check-integrations 仅检查集成
└── 取消"
团队配置已就绪(READY)且用户选了 --redo 时,在覆盖前展示 diff:
── 准备覆盖现有配置 ─────────────────────────
原值: 普通案件周期上限: 30天
新值: 普通案件周期上限: 45天
← 后续字段变化逐行展示
── 确认覆盖?(yes/no) ───────────────────────
用户首次使用或选择重来时进入此阶段。目标:完整填写 team-profile.md。
影响技能: case-management、report-writer
采集:组织名称、行业、主要法域、监管机构。
提问策略:先问是否有现成的介绍(公司官网/About页面/企业信息卡片),有则读取提取,无则逐项填空。2 个问题以内完成本节。
影响技能: case-management、investigation-planner
团队名称、规模、负责人、汇报线。
影响技能: interview-analysis、investigation-planner
关键参数:
| 参数 | 建议提问方式 |
|---|---|
| 同一事项连续通话上限 | "同一个举报线索,最多可以连续联系举报人几次必须停下来复盘?" |
| 通话前背景核查 | "联系举报人之前是否需要先做背景核查?" |
| 通话后强制 call_memo | "每次通话后是否强制输出通话备忘录?" |
| 案件周期上限 | "普通案件从立案到结案,通常希望控制在多少天内?" |
影响技能: case-management、report-writer
逐项确认:立案/数据提取/访谈/报告发布是否需要审批、谁来批。
语言、报告格式、编号规则等。
当检测到 <!-- SETUP PAUSED AT: 章节名 --> 标记时,读取标记指向的章节,从该处继续。前置已填内容不动。
中断保存时机:
<!-- SETUP PAUSED AT: 下一章节名 -->[PENDING](区别于模板的 [PLACEHOLDER])恢复时的对话示例:
> 欢迎回来。上次你在"审批流程"设置完成后暂停了。
> 你的组织信息和团队配置已经保存。
> 上次已完成的:
> ✅ 组织信息
> ✅ 调查团队
> ✅ 调查通信纪律
> ⏸ 审批流程 — 已设置,未中断在此
> □ 报告偏好 — 未开始
> 从"报告偏好"继续?
与当前行为一致——自动检测 MCP 服务器,按类型验证可用性。运行 --check-integrations 时仅执行此阶段。
输出示例:
文件系统操作类 MCP ... ✓
推理辅助类 MCP ... ✓
网络搜索类 MCP ... ✗ (未配置)
→ 建议: 如涉及 OSINT 调查,推荐启用搜索类 MCP
表格数据处理类 MCP ... ✗ (未安装)
→ 建议: 如需 Benford 定律分析,pip install 对应包
首次设置时,按模板结构写入 ~/.claude/plugins/config/cc-investigation/team-profile.md。模板中所有 [PLACEHOLDER] 替换为用户填写值。
插件升级后,config-templates/team-profile.md 可能新增了配置项。检测流程:
1. READ 新模板 (config-templates/team-profile.md)
2. READ 现有用户配置 (~/.claude/plugins/config/cc-investigation/team-profile.md)
3. 按 H2 节逐节对比:
- 模板中存在但配置中不存在的节 → 标记为"新配置项"
- 模板和配置中都存在但配置中有 [PLACEHOLDER] → 标记为"待补全"
- 配置中已填写的字段 → 保留不动
4. 如存在"新配置项"或"待补全"项:
→ "插件升级后新增了以下配置项,需要补充:"
→ 逐项引导填写
5. 无新增项 → "无需变更,配置已是最新"
╔══════════════════════════════════════════════════════════════════╗
║ cc-investigation 配置完成 ║
╠══════════════════════════════════════════════════════════════════╣
║ 组织: XX 集团公司 | 行业: 制造 | 法域: 中国大陆 ║
║ 团队: 调查部 (5人) | 汇报: 审计委员会 ║
║ 通信纪律: 已配置 | 审批流程: 已配置 ║
║ 集成: 3/5 可用 | 缺失: 财务分析, 企业信息查询 ║
╚══════════════════════════════════════════════════════════════════╝
┌─ 推荐的下一步 ──────────────────────────────────────────────────┐
│ /cc-investigation:investigate start 启动第一个案件 │
│ /cc-investigation:cold-start-interview 重新配置 │
│ --check-integrations 检查集成状态 │
└────────────────────────────────────────────────────────────────┘
每次发版更新 config-templates/team-profile.md 时:
[PLACEHOLDER] 标记~/.claude/plugins/config/cc-investigation/* 不会被插件更新覆盖/cc-investigation:cold-start-interview, --check-integrations, --redoCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub sxd007/cc-investigation --plugin cc-investigation