From hicode
初始化目标后端项目的 hicode 使用入口,优先使用 Agent 可执行初始化能力生成 AGENTS.md 或 CLAUDE.md;OpenCode TUI /init 需用户手工执行,Agent 不能代替调用。随后补充 hicode section、项目规则、上下文文档,并按需建议 graphify 代码结构扫描。Use when 用户要求初始化 hicode、补齐 AGENTS.md/CLAUDE.md、创建 docs/rules、建立项目上下文,或准备目标项目进入 hicode 工作流。
How this skill is triggered — by the user, by Claude, or both
Slash command
/hicode:initThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
`hicode:init` 是目标项目初始化入口,只在用户明确要求初始化、补齐 Coding Agent 入口、初始化项目规则、建立项目上下文或梳理代码结构时使用。
hicode:init 是目标项目初始化入口,只在用户明确要求初始化、补齐 Coding Agent 入口、初始化项目规则、建立项目上下文或梳理代码结构时使用。
初始化目标是让目标项目具备 hicode 可用的最小上下文:
AGENTS.md 或 CLAUDE.md。docs/rules/、docs/DOMAIN_KNOWLEDGE.md、docs/PROJ_CONTEXT.md、docs/adr/ 等项目级文档路径明确。本 Skill 不安装 hicode plugin,不复制 plugin 内置 Skill、Agent、Rule、Template 或 Hook 到目标项目本地运行目录,不创建 .hicode/,不扫描生产数据,不操作生产环境。
按当前步骤读取必要材料,不默认全量读取:
coding_rules.mdhicode-entry-section.mdDOMAIN_KNOWLEDGE.mdPROJ_CONTEXT.mdADR-template.md目标项目中已有的 AGENTS.md、CLAUDE.md、docs/rules/、docs/DOMAIN_KNOWLEDGE.md、docs/PROJ_CONTEXT.md 和 docs/adr/ 必须优先保留。发现冲突时先列出冲突,不得直接覆盖。
用户说:“在这个业务仓库初始化 hicode。”
执行顺序:
AGENTS.md 还是 CLAUDE.md。/init,说明不能代替执行,并推荐在用户确认后生成最小入口。hicode-entry-section.md 中的 hicode section 补充到入口文件。docs/rules/ 和项目级上下文文档。先确认目标项目根目录,避免把 hicode plugin 仓库当成业务项目初始化。
入口类型按平台判断:
| 平台 | 入口文件 |
|---|---|
| Codex、OpenCode、其他 AGENTS 约定平台 | AGENTS.md |
| Claude Code | CLAUDE.md |
如果平台或目标目录不明确,只问一个问题并停止推进。
如果 AGENTS.md 和 CLAUDE.md 同时存在,只处理当前平台入口;是否同步另一个入口必须单独询问用户。
入口文件缺失时:
/init,例如 OpenCode,则不得声称已执行 /init;应说明用户可在终端手工输入 /init 后再继续,并把“确认后由 hicode 生成最小入口文件”作为推荐继续路径。/init 的项目分析结果。入口文件已存在时:
hicode-entry-section.md 补充或刷新 hicode section。docs/rules/、单需求目录和推荐 hicode Skill。根据目标项目类型、技术栈和风险特征判断适用规则。
处理规则:
docs/rules/ 下创建或更新项目规则。coding_rules.md 复制。待确认 标注差异。docs/rules/ 文件优先保留;冲突未确认前不得覆盖。检查并按需创建:
docs/DOMAIN_KNOWLEDGE.mddocs/PROJ_CONTEXT.mddocs/adr/docs/rules/创建规则:
DOMAIN_KNOWLEDGE.md 时,先读取模板,再写入已确认领域术语、业务域和可复用规则;未知内容写 待确认。PROJ_CONTEXT.md 时,先读取模板,再写入已确认项目定位、模块结构、核心流程、接口依赖和历史风险;未知内容写 待确认。docs/adr/ 可以只创建目录。只有存在难逆、意外且有真实取舍的决策时,才基于 ADR-template.md 生成 ADR 草稿。docs/features/<feature-id>/,入口 hicode section 应指向该路径。不得把推断写成事实。上下文正式沉淀需要负责人确认。
规则和项目文档处理完成后,再判断是否建议代码结构扫描。
先用只读、低风险信号判断复杂度:
不得读取 .env*、密钥、生产配置、生产凭证、未脱敏客户信息、未脱敏生产数据、生产日志、构建产物、依赖目录或日志目录。
只有命中以下复杂度信号时,才建议 graphify:
如果用户同意:
如果 graphify 不可用,不自行联网安装;一次只问用户是否允许安装或改用轻量目录梳理。
命中以下情况时停止,输出 待确认 或 阻塞:
docs/rules/ 或项目级文档。.hicode/、连接生产、发布、回滚、合并、推送或修改生产配置。默认输出 Markdown,包含:
完成 / 部分完成 / 仅计划 / 阻塞 / 待确认/init,说明它是用户手工 TUI 命令、平台不支持或用户未确认。docs/rules/ 创建、更新、跳过和冲突清单。DOMAIN_KNOWLEDGE.md、PROJ_CONTEXT.md、docs/adr/ 处理清单。不得输出最终审批、合并许可、发布许可、生产命令或生产验证结果。
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub jaminzzhang/hicode --plugin hicode