AGENT SKILL

codewiki-初始化多仓WIKI工作区

把当前工作目录初始化(或重新同步)为多仓工作区:生成 bootstrap 克隆脚本、.gitignore、repo-map 导航骨架、AGENTS.md 工作区约定与产品级 repowiki,并默认启用任务管理接线(接线目标恒为工作区根)与编译宿主技能文件——初始化一次性把必要配置做好。首次初始化必须先询问用户知识布局(colocated/centralized)再带 layout 调用,布局记录写入 repowiki/.meta/workspace.json;重跑零配置幂等——痕迹齐备时为 clone-only 接管(只补缺业务仓克隆,不触碰骨架与 AGENTS.md),骨架有缺失才补齐产物并强制刷新约定块。业务仓登记走 add_workspace_repo。

License 许可
MIT
最近更新
2026-11-13
Stars
★ 21
Forks
4

01 前言 Front Matter

name
codewiki-初始化多仓WIKI工作区
description
把当前工作目录初始化(或重新同步)为多仓工作区:生成 bootstrap 克隆脚本、.gitignore、repo-map 导航骨架、AGENTS.md 工作区约定与产品级 repowiki,并默认启用任务管理接线(接线目标恒为工作区根)与编译宿主技能文件——初始化一次性把必要配置做好。首次初始化必须先询问用户知识布局(colocated/centralized)再带 layout 调用,布局记录写入 repowiki/.meta/workspace.json;重跑零配置幂等——痕迹齐备时为 clone-only 接管(只补缺业务仓克隆,不触碰骨架与 AGENTS.md),骨架有缺失才补齐产物并强制刷新约定块。业务仓登记走 add_workspace_repo。
disable-model-invocation
true

03 SKILL.md 正文

初始化多仓WIKI工作区

把当前工作目录初始化(或重新同步)为多仓工作区:生成 bootstrap 克隆脚本、.gitignore、repo-map 导航骨架、AGENTS.md 工作区约定与产品级 repowiki,并默认启用任务管理接线(接线目标恒为工作区根)与编译宿主技能文件——初始化一次性把必要配置做好。首次初始化必须先询问用户知识布局(colocated/centralized)再带 layout 调用,布局记录写入 repowiki/.meta/workspace.json;重跑零配置幂等——痕迹齐备时为 clone-only 接管(只补缺业务仓克隆,不触碰骨架与 AGENTS.md),骨架有缺失才补齐产物并强制刷新约定块。业务仓登记走 add_workspace_repo。

调用 MCP 获取完整工作流并按其执行:

get_prompt(name="init-workspace", arguments={"workspace_path": "."})

可选开关参数(默认值即上述调用;用户调用本技能时附带的相关意愿,先映射进 arguments 再调用 get_prompt,不要丢弃):

  • enable_task_management:默认启用任务管理接线;用户明确表示不启用任务管理(如回答「否」/「不要」)时传 "false"
  • capture:默认 on;用户明确表示关闭对话采集时传 "off"

返回的工作流包含分阶段指引,逐步照做即可。 不要凭记忆执行——模板真源在 codewiki/mcp/prompts.py,以 get_prompt 返回内容为准。 本技能是手动触发入口(disable-model-invocation: true),不占常驻上下文;由用户显式调用 /codewiki-初始化多仓WIKI工作区 触发。

04 同仓库更多 Skills

mambo-wang
mambo-wang/CodeWiki-Plus

write-doc-file-content-file-sidechannel

write_doc_file 建档报目标路径已被手写文件占用/路由冲突时——走 content_file 临时文件侧通道:正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

windows-python-release

当要手动发布 Python 包(codewiki-plus)到 PyPI 并建 GitHub Release 时——CI 不发布、Windows 控制台为 GBK、可能无 gh CLI、本机网络对 upload.pypi.org 的 Python TLS 握手有干扰——先核对 tag 区间与工作区未提交改动定 bump 级别,再按 8 步主干执行:同步四处版本→bump 提交(只 add 具体文件)→聚焦+ruff+全量闸门→清 dist 构建→PR 合并 main→tag merge commit 建 Release→uv publish(TLS 超时则 curl.exe 直传)→PyPI JSON API 核对

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

windows-dev-env

Windows/PowerShell 下做 git 写操作、跑子进程或批量文件/测试清理时:shell 漂移与中文路径致命令静默失败、无控制台宿主子进程闪窗、GCM 每次弹 OAuth 框、原生 DLL 被锁——须显式复核落盘、subprocess 加 CREATE_NO_WINDOW、gh auth setup-git 持久化凭据,并用 cmd /c 绕 safe-delete 钩子

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

repowiki-conclusion-update

已落库 repowiki 结论发生变化时,按「结论方向 vs 表述」分流:方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR,仅表述/证据变则 edit_doc_file 原地改

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

maintain-fork-pr-merge

当合入 fork 来源的 PR 且 mergeStateStatus=CONFLICTING/DIRTY 时——先 git merge-tree 探测冲突清单,查 maintainer_can_modify,再在 worktree 隔离目录解冲突后 push fork 分支,勿因 CI 绿直接 merge

★ 21
mambo-wang
mambo-wang/CodeWiki-Plus

git-commit-hygiene

在共享 worktree 多会话并行或暂存区有残留时提交代码——用显式 pathspec 只提交自己的文件并排除临时目录,禁止 git add -A 或裸 commit 扫入并行会话的改动

★ 21