记录技术实践、折腾过程与日常思考。https://coding.knifelf.club/zh-CNhttps://coding.knifelf.club/blog/claude-prompt-audit-stale-instructions/https://coding.knifelf.club/blog/claude-prompt-audit-stale-instructions/部署已经迁移，agent 却还在照旧文档跑命令？用 Claude Code 的指令审计找出失效路径、冲突规则和旧流程，再用真实构建验证修改。Mon, 12 Oct 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-memory-promotion-contract/https://coding.knifelf.club/blog/agent-memory-promotion-contract/把临时发现、重复纠错和硬性约束分开管理，避免项目指令逐渐膨胀，最后谁也不遵守。Wed, 30 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/permission-denied-retry-playbook/https://coding.knifelf.club/blog/permission-denied-retry-playbook/自动模式拒绝工具调用时，最浪费时间的不是那次拒绝，而是 agent 带着同一条命令反复撞墙。把拒绝原因变成受约束的改道提示，再决定哪些场景允许重试。Tue, 29 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/post-tool-batch-integration-gate/https://coding.knifelf.club/blog/post-tool-batch-integration-gate/一次并行调用五件事，单点都成功但合起来不成立。Claude Code 在整批工具调用结算后留了 PostToolBatch 触发点，用它做批后集成检查，再用 Stop 把没验证的改动拦回去。Mon, 28 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-code-intelligence-lsp-setup/https://coding.knifelf.club/blog/agent-code-intelligence-lsp-setup/代码导航从字符串匹配换成符号图：编辑后先拿诊断，再按符号跳转。三步接入、CLAUDE.md 里的分工写法，以及实测出来的 token 变化。Sun, 27 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/change-aware-hook-test-routing/https://coding.knifelf.club/blog/change-aware-hook-test-routing/把 agent 的文件改动映射到最小验证命令。先用 Hook 识别路径，再跑对应检查，最后用全量测试守住合并门。Sat, 26 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agents-md-directory-contract/https://coding.knifelf.club/blog/agents-md-directory-contract/别再把一仓库规则塞进根目录。用 AGENTS.md 的层级覆盖，把可改文件、验收命令和升级条件贴在代码旁边，让 agent 的默认动作变得可审计。Fri, 25 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/hook-blocking-signal-contract/https://coding.knifelf.club/blog/hook-blocking-signal-contract/exit 1 表示失败是 Unix 常识，放进 hook 里却等于把门开着。把拦截信号按事件对齐，再用一台本地自检台证明它真的拦得住。Thu, 24 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/pretooluse-command-boundary/https://coding.knifelf.club/blog/pretooluse-command-boundary/拦截型 hook 的价值取决于它有没有真的触发。用 if 条件收窄触发面，用信任规则和调试日志证明它确实在跑。Wed, 23 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/mcp-stateless-server-migration/https://coding.knifelf.club/blog/mcp-stateless-server-migration/2026-07-28 这版 MCP 把会话从核心请求路径里拿掉了。把状态搬进显式 handle、用多轮往返换掉服务端发起的请求、给网关补上头部路由，再按清单逐条验收。Tue, 22 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/path-scoped-agent-acceptance-contract/https://coding.knifelf.club/blog/path-scoped-agent-acceptance-contract/全仓库 AGENTS.md 很快会变成一锅粥。把稳定约束留在根目录，把框架和目录差异下沉到路径级指令，再让测试夹具证明它们真的被读取。Mon, 21 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/vscode-custom-agent-change-contract/https://coding.knifelf.club/blog/vscode-custom-agent-change-contract/自定义代理值钱的地方不是人格设定，而是工具白名单。按角色拆开 tools、agents 和 handoffs，越权就从语气问题变成了配置问题；但白名单是否强制执行，取决于你用哪个 harness。Sun, 20 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/copilot-hook-stdout-contract/https://coding.knifelf.club/blog/copilot-hook-stdout-contract/Copilot hook 的判定完全依赖 stdout：progress 行被剥掉，剩下的行拼成单个 JSON 文档再解析。一次 echo 调试、一个写错的正则，都能让闸门无声消失。Sat, 19 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/dynamic-workflow-fanout-control/https://coding.knifelf.club/blog/dynamic-workflow-fanout-control/子代理派到几十个就乱了。Claude Code 的动态工作流把计划和分支写进脚本，代价是并发、恢复和成本都得你自己管。这里是我跑大规模扇出前会先看的几条硬边界。Fri, 18 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/subagent-skill-role-contract/https://coding.knifelf.club/blog/subagent-skill-role-contract/别给所有子代理塞同一套长提示。用预加载 Skill 定义角色，用文件契约交接，把计划、实现和验收拆成可复查的流水线。Thu, 17 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-unattended-isolation-baseline/https://coding.knifelf.club/blog/agent-unattended-isolation-baseline/让 coding agent 少问甚至不问的前提不是提示词，而是隔离边界和出网白名单。用官方 dev container 参考配置搭一套默认拒绝出网的容器：非 root 用户、ipset 白名单、托管设置禁掉 bypass，再逐条排查会悄悄吃掉隔离的四个配置。Wed, 16 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/mcp-tool-context-budget/https://coding.knifelf.club/blog/mcp-tool-context-budget/工具注册和返回值都在花 agent 的上下文。按「首块必须自包含」重写 MCP 工具：默认小 limit、显式截断标记、可切换的 concise 返回。Mon, 14 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-hook-feedback-loop/https://coding.knifelf.club/blog/agent-hook-feedback-loop/把格式化、定向测试和失败摘要挂到 agent 的工具调用之后，让错误在下一步决策前出现，而不是堆到提交前。Sun, 13 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-stage-gates/https://coding.knifelf.club/blog/agent-stage-gates/把复杂改动拆成侦察、实施、验收三段：先用只读 agent 收敛证据，再让执行 agent 改动，最后用独立验证关卡决定是否交付。Sat, 12 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/cache-aware-agent-cost-audit/https://coding.knifelf.club/blog/cache-aware-agent-cost-audit/压掉 38% 工具输出 token，账单反而涨 6.8%。把成本拆成输入、缓存写、缓存读、输出四格，再加上空闲驱逐这条暗线，才能看清 coding agent 的钱花在哪。Fri, 11 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/skill-trigger-evals/https://coding.knifelf.club/blog/skill-trigger-evals/Skill 的 description 实际上是 agent 的路由规则。把真实任务写成应触发与不应触发的测试集，再记录误触发和漏触发，才能让 Skill 库越长越可靠。Thu, 10 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/subagent-routing-production-rules/https://coding.knifelf.club/blog/subagent-routing-production-rules/description 是派单系统的路由表，工具列表是能力边界，per-agent hook 是审计员。四件事都固化下来，委托才从模型的即兴发挥变成可审查的常量。Wed, 09 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/diff-budget-acceptance-gate/https://coding.knifelf.club/blog/diff-budget-acceptance-gate/agent 一小时能产出人类一天都审不完的 diff。与其事后在巨型 PR 里找问题，不如把变更大小、测试和破坏性改动写进验收清单，再用 hook 在它声称完成的那一刻强制检查。Tue, 08 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/fix-with-copilot-ci-loop/https://coding.knifelf.club/blog/fix-with-copilot-ci-loop/PR 红了别急着翻日志。Fix with Copilot 把调查、修复、推分支交给 GitHub 云 agent，人只读 diff、批准重跑、再合并。Mon, 07 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-worktree-isolation/https://coding.knifelf.club/blog/agent-worktree-isolation/子代理并行时最怕互相踩 diff：两个 agent 同时改同一个工作目录，后写的一方静默覆盖先写的一方。用 isolation: worktree 让每个写代码的子代理落在独立 git worktree 里，并行才真正成立。Sun, 06 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/subagent-evidence-contract/https://coding.knifelf.club/blog/subagent-evidence-contract/把子代理输出从一段“看起来合理”的总结，改造成主代理能复查、能执行、能拒绝的证据包。Sat, 05 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-skills-instruction-budget/https://coding.knifelf.club/blog/agent-skills-instruction-budget/把稳定约束留在 AGENTS.md，把按需展开的复杂流程封装为 Skills，再以只读子代理隔离噪声，给 coding agent 一套能长期维护的操作系统。Fri, 04 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/execplan-long-running-agent/https://coding.knifelf.club/blog/execplan-long-running-agent/把长任务的目标、进度、决策和验收写进一份持续更新的 ExecPlan，让 agent 可以中断后继续，也让人能随时审计它到底做了什么。Thu, 03 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/hooks-automation-bus/https://coding.knifelf.club/blog/hooks-automation-bus/PreToolUse 拦截只是 hook 的入门用法。上下文注入、环境同步、通知、后台测试、审计日志，同一套事件总线把 coding agent 变成确定性的自动化流水线，而且 Claude Code、VS Code、Copilot 共用同一份 JSON 配置。Wed, 02 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-instructions-layered-scoping/https://coding.knifelf.club/blog/agent-instructions-layered-scoping/把全局原则、目录约束和任务卡分层放置，让 coding agent 在正确的文件范围内拿到正确的规则，减少冲突和无效上下文。Tue, 01 Sep 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agents-md-project-context/https://coding.knifelf.club/blog/agents-md-project-context/AGENTS.md 每次会话都会进上下文，是性价比最高的 agent 提效文件。命令先行、短而具体、边界明确、按目录嵌套，四条规则让规则真正被遵守。Mon, 31 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/subagent-merge-boundaries/https://coding.knifelf.club/blog/subagent-merge-boundaries/并行不是多开几个 agent。给每个子代理缩小任务、工具和写入面，再让主代理做唯一集成者，才能避免互相覆盖。Sun, 30 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/claude-hooks-guardrail-playbook/https://coding.knifelf.club/blog/claude-hooks-guardrail-playbook/CLAUDE.md 是建议，hook 是规定。从 stdin JSON 协议、退出码语义到 prompt/agent 型 hook，把编码 agent 的每个动作变成可拦截、可验证、可审计的确定性流程。Sat, 29 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/claude-goal-completion-conditions/https://coding.knifelf.club/blog/claude-goal-completion-conditions/把完成条件写成可验证的句子，agent 自己循环到满足为止。终点、证据、边界、上限，缺一个就烧 token。Fri, 28 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/agent-guardrails-hooks-acceptance/https://coding.knifelf.club/blog/agent-guardrails-hooks-acceptance/别把项目规范只写在提示词里。用持久规则、命令闸门和可追溯的验收结果，压住 coding agent 的重复性失误。Thu, 27 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/parallel-agents-boundaries/https://coding.knifelf.club/blog/parallel-agents-boundaries/让多个 coding agent 同时干活，最难的不是开更多窗口，而是设计它们交付什么、谁能改哪里、结果怎样合并。Wed, 26 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/bledebug-ble-toolbox/https://coding.knifelf.club/blog/bledebug-ble-toolbox/面向开发者、硬件爱好者和嵌入式工程师的 BLE 调试工具：扫描、连接、GATT 浏览、HEX/ASCII 收发、广播监听与本地日志。Tue, 25 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/spec-kit-1-0-spec-driven-workflow/https://coding.knifelf.club/blog/spec-kit-1-0-spec-driven-workflow/GitHub 开源的 Spec Kit 满一岁并发布 1.0.0。constitution、converge 循环和 [NEEDS CLARIFICATION] 标记，把 Vibe Coding 从碰运气变成可验收的流程。Tue, 25 Aug 2026 00:00:00 GMThttps://coding.knifelf.club/blog/vibe-coding-agent-handoff/https://coding.knifelf.club/blog/vibe-coding-agent-handoff/别让下一个 agent 重走已经失败的路径。一个短小的交接文件，往往比更长的上下文更有用。Tue, 25 Aug 2026 00:00:00 GMT